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内 容 简 人 

本 书 详细 曾 述 了 与 Spring Cloud 微服 务 框架 相关 的 基本 解决 方案 ， 主 要 包括 微服 务 简 介 、 使 用 微服 务 
的 Spring、Spring Cloud 概述 、 服 务 发 现 、 使 用 Spring Cloud Config 进行 分 布 式 配 置 、 微 服务 之 间 的 通信 、 
高 级 负载 均衡 和 断路 器 、 使 用 API 网 关 进 行路 由 和 过 滤 、 分 布 式 日 志 记 录 和 跟踪 、 其 他 配置 和 发 现 功能 、 
消 轧 驱动 的 微服 务 、 保 护 API 的 安全 、 测 试 Java 微服 务 、Docker 支持 、 云 平台 上 的 Spring 微服 务 等 内 容 。 
此 外 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 进一步 理解 相关 方案 的 实现 过 程 。 

本 书 适 合作 为 高 等 院 校 计算 机 及 相关 专业 的 教材 和 教学 参考 书 , 也 可 作为 相关 开发 人 员 的 目 学 教材 和 
参考 手册 。 
Copyrieht © Packt Publishing 2018.First published m the Enelish laneuage under the title 
Mastering Spring Cloud. 
Simplified Chinese-laneuage edition © 2019 by Tsmehua UnIVerslty Press.All rights reserved. 

本 书 中 文 简体 字 版 由 Packt Publishing 授权 清华 大 学 出 版 社 独家 出 版 。 未 经 出 版 者 书面 许可 , 不 得 以 任 
何方 式 复制 或 抄 多 本 书 内容 。 
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译 者 序 


在 过 去 的 2018 年 ， 有 两 个 词汇 经 常 挂 在 开发 人 员 的 嘴 上 ， 一 个 是 “ 微 信 小 程序 ”， 
一 个 是 “微服 务 架 构 ”， 而 能 把 它们 连接 在 一 起 的 ， 有 一 个 更 热门 的 词汇 ， 那 就 是 Spring 
Cloud 。 

“微服 务 ” 的 概念 是 由 ThoughtWorks 公司 的 首席 科学 家 Martin 提出 的 ， 他 是 敏捷 开 
发 方法 的 创始 人 之 一 ， 上 自然 而 然 地 ， 微 服务 的 目的 束 是 有 效 拆 分 应 用 ， 实 现 敏 捷 开 发 和 部 
署 。 与 之 相对 应 的 ， 此 前 的 软件 开发 都 是 基于 一 体 化 架构 。 一 体 化 架构 的 优点 是 开发 简单 
直接 、 集 中 式 管 理 、 功 能 都 在 本 地 ; 但 是 ， 一 旦 应 用 程序 变 大 、 团 队 扩张 ， 那 么 一 体 化 架 
构 的 缺点 束 会 立即 凸显 ， 庞 大 的 一 体 代 人 码 库 可 能 会 让 新 手 程序 员 望 而 生 綦 ， 再 加 上 开发 效 
率 低 、 代 码 维护 困难 、 部 署 不 灵活 、 难 以 扩展 应 用 等 ， 这 些 很 可 能 成 为 企业 和 开发 人 员 难 
以 通 越 的 障碍 。 微 服务 的 出 现 解决 了 这 些 了 矛盾 ， 它 将 系统 拆 分 成 进程 独立 的 服务 ， 进 行 分 
布 式 管理 、 目 动 化 运 维 ， 通 过 API 网 和 天、 服务 间 调 用 、 服 务 发 现 、 服 务 容错 、 服 务 部 署 和 
数据 调用 实现 了 开发 简单 、 独 立 按 震 扩展 、 高 可 用 性 、 持 续集 成 和 持续 交付 等 ， 特 别 契 合 
云 平台 应 用 程序 开发 的 需要 ， 这 也 正 是 它 日 益 流行 的 原因 。 

Spring Cloud 是 微服 务 架 构 开 发 的 完美 解决 方案 ， 它 是 一 套 分 布 式 服务 治理 的 框架 ， 
专注 于 全 局 微服 务 协 调整 理 ， 可 以 将 各 个 单独 的 微服 务 整 合并 管理 起 来 ， 为 各 个 微服 务 之 
间 提 供 配 置 管理 、 服 务 发 现 、 断 路 露 、 路 由 、 消 息 代 理 、 事 件 总 线 、 诀 策 竞 选 、 分 布 式 会 
话 等 集成 服务 。Spring Cloud 本 吴 不 提供 有 具体 功能 性 的 操作 ， 更 专注 于 服务 之 间 的 通信 、 
熔断 和 监控 等 ， 因 此 就 需要 很 多 组 件 来 文 持 完整 功能 。 本 书 介绍 的 Spring Cloud 的 可 用 组 
件 及 其 主要 功能 包括 : Spring Cloud Netflix Eureka 〈 服 务 皮 现 ) 、Spring Cloud Config (分 
布 式 配 置 )、Spring RestTemplate 和 Feign 客户 端 (服务 间 通信 ) 、Ribbon (负载 均衡 算法 ) 、 
Hystrix (断路 器 模式 和 仪表 板 监控 ) 、Spring Cloud Netlix Zuul (路 由 和 过 滤 ) 、Spring Cloud 
Sleuth (分 布 式 服务 跟踪 ) 、Consul 和 ZooKeeper (服务 发 现 和 分 布 式 配置 ) 、RabbitMQ 
和 Apache Kafka (消息 代理 ) 、Spring Cloud Contract (契约 测试 ) 、Gatling (自动 化 测试 ) 、 
Jenkins (持续 集成 服务 器 ) 和 Kubernetes 平台 等 。 此 外 ， 本 书 还 介绍 了 Docker 容器 和 两 个 
支持 Java 应 用 程序 的 流行 云 平 台 : Pivotal Cloud Foundry 和 Heroku。 相 信和 在 阅读 本 书 之 后 ， 
读者 会 对 Spring Cloud 和 Spring Boot 框架 的 应 用 和 开发 有 一 个 高 屋 建 钥 的 认识 ,并 掌握 各 
个 组 件 的 应 用 技巧 ， 熟 练 驾 驭 微服 务 应 用 程序 的 开发 。 


“II* 精通 Spring Cloud 微服 务 架 构 


在 翻译 本 书 的 过 程 中 ， 为 了 更 好 地 帮助 读者 理解 和 学 习 ， 本 书 以 中 英文 对 照 的 形式 保 
留 了 大 量 的 术语 ， 这 样 的 安排 不 但 方便 读者 理解 书 中 的 代码 ， 而 且 也 有 助 于 读者 查找 和 利 
用 本 书 配套 网 站 上 的 资源 。 

本 书 由 黄 进 青 翻 译 ， 马 宏 华 、 唐 盛 、 郝 艳 杰 、 黄 永 强 、 陈 凯 、 熊 爱 华 、 黄 刚 等 也 参与 
了 部 分 翻译 工作 。 由 于 译 者 水 平 有 限 ， 错 漏 之 处 在 所 难免 ， 在 此 诚挚 欢迎 读者 提出 任何 意 
见 和 建议 。 
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开发 、 部 署 和 运营 云 应 用 程序 应 该 像 本 地 应 用 程序 一 样 简单 。 这 应 该 是 任何 云 平台 、 
库 或 工具 背后 的 管理 原则 。Spring Cloud 可 以 轻松 地 为 云 开 发 JVM 应 用 程序 。 本 书 将 介绍 
Spring Cloud 并 帮助 开发 人 员 掌 握 其 功能 。 

本 书 首 先 介 绍 如 何 配 置 Spring Cloud 服务 器 并 运行 Eureka 服务 器 以 局 用 服务 注册 和 发 
现 ， 然 后 再 深入 剖析 与 负载 均衡 和 断路 相关 的 技术 ， 包 括 利用 Feign 客户 端的 所 有 功能 ; 
最 后 讨论 和 研究 高 级 主题 ， 包 括 如 何 为 Spring Cloud 实现 分 布 式 跟 踪 解决 方案 并 构建 消息 
驱动 的 微服 务 架构 。 


本 书 适合 的 读者 


本 书 对 热衷 于 利用 Spring Cloud 的 开发 人 员 有 很 强 的 吸引 力 。Spring Cloud 是 一 个 开源 
库 ， 可 帮助 开发 人 员 快 速 构 建 分 布 式 系统 。 了 解 Java 和 Spring Framework 将 对 本 书 的 学 习 
很 有 帮助 ， 但 之 前 不 需要 接触 Spring Cloud。 


本 书 内 容 综述 


本 书 的 写作 思路 明确 ， 结 构 简 单 易 懂 。 全 书 共 分 为 3 个 部 分 ， 第 一 部 分 是 “微服 务 架 
构 和 Spring Cloud 项 目 基 础 知识 ”, 包括 第 1 章 一 第 3 章 , 详细 介绍 了 微服 务 、Spring Boot 
和 Spring Cloud 的 基础 知识 。 
口 第 1 章 “ 微 服务 简介 ”， 将 介绍 微服 务 架 构 、 云 环境 等 。 读 者 将 学 习 并 理解 基于 
微服 务 的 应 用 程序 和 一 体 化 应 用 程序 之 间 的 区 别 ， 同 时 了 解 如 何 迁 移 到 微服 务 应 
用 程序 。 

口 第 2 章 “ 使 用 微服 务 的 Spring”， 将 介绍 Spring Boot 框架 。 本 章 将 详细 说 明 如 何 
有 效 地 使 用 Spring Boot 框架 来 创建 微服 务 应 用 程序 。 此 外 还 将 介绍 使 用 Spring 
MVC 注解 创建 REST API、 使 用 Swagger2 提供 API 文档 ， 以 及 使 用 Spring Boot 
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Actuator 端点 公开 运行 状况 检查 和 指标 数据 等 主题 。 


第 3 章 “Spring Cloud 概述 ”， 将 简要 介绍 作为 Spring Cloud 一 部 分 的 主要 项 目 。 
它 将 侧重 于 说 明 Spring Cloud 实现 的 主要 模式 并 将 它们 分 配给 特定 项 目 。 


本 书 的 第 二 部 分 是 “微服 务 架 构 常 见 元 素 和 Spring Cloud 实现 ”， 包 括 第 4 章 一 第 13 
详细 介绍 了 Spring Cloud 各 个 组 件 的 配置 和 应 用 。 


UU 


第 4 章 “ 服 务 发 现 ”， 将 使 用 Spring Cloud Netflix Eureka 摘 述 服务 发 现 模式 。 本 
章 将 详细 说 明 如 何在 独立 模式 下 运行 Eureka 服务 器 , 以 及 如 何 使 用 对 等 副本 运行 
多 个 服务 器 实例 。 此 外 还 将 介绍 如 何在 客户 端 启用 发 现 并 在 不 同 区 域 中 注册 这 些 
客户 端 。 
第 5 章 “ 使 用 Spring Cloud Config 进行 分 布 式 配置 ”， 将 详细 介绍 如 何在 应 用 程 
序 中 使 用 Spring Cloud Config 进行 分 布 式 配置 .本 章 将 说 明 如 何 使 用 Spring Cloud 
Bus 司 用 属性 源 的 不 同 后 端 存 储 库 并 推送 更 改 通 知 。 通 过 比较 发 现 第 一 个 引导 程 
序 和 配置 第 一 个 引导 程序 方法 ， 详 细 说 明了 发 现 服务 和 配置 服务 器 之 间 的 集成 。 
第 6 章 “ 微 服务 之 间 的 通信 ”， 将 摘 述 参与 服务 间 通 信 的 最 重要 元 素 : HTTP 客 
户 端 和 负载 均衡 器 。 本 章 将 详细 介绍 如 何在 有 或 没有 服务 发 现 的 情况 下 使 用 
pa RestTemplate、Ribbon 和 Feiegn 客户 端 。 
第 7 章 “ 高 级 负载 均衡 和 断路 器 ”， 将 描述 与 微服 务 之 间 的 服务 间 通 信 相 关 的 更 
高 级 主题 本 章 将 详细 介绍 如 何 使 用 Ribbon 客户 端 实现 不 同 的 负载 均衡 算法 , 使 
用 Hystrix 局 用 上 断路 器 模式 并 使 用 Hystrix 仪表 板 监控 通信 统计 信息 。 
第 8 章 “ 使 用 API 网 关 进 行路 由 和 过 滤 ”， 将 比较 用 作 Spring 云 应 用 程序 的 API 
网 关 和 代理 的 两 个 项 目 : Spring Cloud Netlix Zuul 和 Spring Cloud Gateway。 本 章 
将 详细 介绍 如 何 将 它们 与 服务 发 现 集成 ， 并 创建 简单 而 更 高 级 的 路 由 和 过 滤 
规则 。 
第 9 章 “ 分 布 式 日 志 记 录 和 跟踪 ”， 将 介绍 一 些 流行 的 工具 ， 用 于 收集 和 分 析 由 
微服 务 生成 的 日 志 记 录 和 跟踪 信息 。 本 章 将 说 明 如 何 使 用 Spring Cloud Sleuth 附 
加 跟踪 信息 和 关联 消息 ， 此 外 还 将 运行 与 Elastic Stack 集成 的 示例 应 用 程序 ， 以 
便 发 送 日 志 消 息 ， 并 使 用 Zipkin 来 收集 跟踪 的 信息 。 
第 10 章 “ 其 他 配置 和 发 现 功能 ”， 将 介绍 两 种 用 于 服务 发 现 和 分 布 式 配置 的 流 
行 产品 : Consul 和 ZooKeeper。 本 章 将 详细 说 明 如 何在 本 地 运行 这 些 工具 ， 并 将 
Spring Cloud 应 用 程序 与 它们 集成 在 一 起 。 
第 11 章 “ 消 恩 驱 动 的 微服 务 ”， 将 指导 开发 人 员 如 何在 微服 务 之 间 提 供 异 步 的 、 
消息 驱动 的 通信 。 本 章 将 详细 介绍 如 何 将 RabbitMQ 和 Apache Kafka 消息 代理 与 


llls 
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Spring Cloud 应 用 程序 集成 ， 以 实现 异步 一 对 一 和 发 布 /订阅 通信 方式 。 

第 12 章 “ 保 护 API 的 安全 ”， 将 描述 保护 微服 务 的 各 种 方法 。 本 章 将 实现 一 个 
由 所 有 先前 引入 的 元 素 组 成 的 系统 ， 这 些 元 素 通过 SSL 相互 通信 。 此 外 还 将 详细 
说 明 如 何 使 用 OAuth2 和 JWT 令 牌 来 给 传 入 API 的 请 求 授权 。 

第 13 章 “ 测 试 Java 微服 务 ”， 将 描述 微服 务 测试 的 不 同 策略 。 它 将 侧重 于 演示 
由 使 用 者 驱动 的 契约 测试 ， 这 尤其 适用 于 基于 微服 务 的 环境 。 此 外 还 将 介绍 如 何 
使 用 Hoverfly、Pact、Spring Cloud Contract、Gatling 等 框架 来 实现 不 同类 型 的 目 
动 化 测试 。 


本 书 的 第 三 部 分 是 “Docker 文 持 和 Spring Cloud 平台 ”， 包 括 第 14 章 一 第 15 章 ， 详 
细 介 绍 了 Docker 容 右 、Pivotal Cloud Foundry 和 Heroku 云 平 台 。 
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第 14 章 “Docker 文 持 ”， 将 简要 介绍 Docker。 它 将 侧重 于 描述 最 常用 的 Docker 
命令 ， 这 些 命令 用 于 在 容器 化 环境 中 运行 和 监视 微服 务 。 此 外 还 将 详细 说 明 如 何 
使 用 流行 的 持续 集成 服务 器 (Jenkins ) 构建 和 运行 容器 ， 并 将 它们 部 署 在 
Kubernetes 平台 

第 15 章 “ 云 平台 上 的 Spring 微服 务 ”， 将 介绍 两 个 文 持 Java 应 用 程序 的 流行 云 
平台 : Pivotal Cloud Foundry 和 Heroku。 本 章 将 详细 说 明 如 何 使 用 命令 行 工 具 或 
Web 控制 台 在 这 些 平 台 上 部 署 、 局 动 、 扩 展 和 监视 应 用 程序 。 


阅读 基础 


要 顺利 阅读 本 书 并 完成 所 有 代码 示例 ， 读 者 应 具备 以 下 基础 条 件 : 
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有 效 的 互联 网 连接 
Java 8+ 

Docker 

Maven 

Git 客户 端 


下 载 示 例 代码 文件 


读者 可 以 从 www.packtpub.com 下 载 本 书 的 示例 代码 文件 。 具 体 步 又 如 下 : 


*。VI。 精通 Spring Cloud 微服 务 架 构 


(1 ) 登录 或 注册 www.packtpub.com 。 
(2) 选择 Support( 文 持 ) 选项 卡 。 
(3) 单 击 Code Downloads&Errata (代码 下 载 和 勘误 表 ) 。 
(4) 在 Search (搜索 ) 框 中 输入 图 书 名 称 Mastering Spring Cloud， 然 后 按照 屏幕 上 
的 说 明 进 行 操作 。 
下 载 文件 后 ， 请 确保 使 用 最 新 版 本 解压 缩 或 解压 缩 文 件 夹 : 
口 WinRAR/7-Zip (Windows 系统 ) 
口 “Zipeg/iZip/UnRarX (Mac 系统 ) 
口 7-Zip/PeaZip (Linux 系统 ) 
该 书 的 代码 包 也 已 经 在 GitHub 上 托管 ， 网 址 为 https://github.conyPacktPublishing/ 
Masterine-Spring-Cloud， 欢 迎 访 问 。 


本 书 约定 


本 书 中 使 用 了 许多 文本 约定 。 
(1 ) CodeInText: 表示 文本 中 的 代码 字 、 数 据 库 表 名 、 文 件 夹 名 、 文 件 名 、 文 件 扩展 
名 、 路 径 名 、 虚 拟 URL、 用 户 输入 和 Twitter 句柄 等 。 以 下 段落 就 是 一 个 示例 。 
“HTTP API 端点 (http://localhost:8889/client-service-zone3.yml) 的 最 后 一 个 可 用 版 本 ， 
返回 与 输入 文件 相同 的 数据 。” 
(2) 有 关 代 人 码 块 的 设置 如 下 所 示 。 
<dependency> 


<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-config-server</artifactId> 


</dependency> 

(3) 当 我 们 希望 引起 读者 对 代码 块 的 特定 部 分 的 注意 时 ， 相 关 的 行 或 项 目 以 粗 体 显 示 。 
SpIring: 

rabbitmaq: 


host: 192.168.99.100 
port: 5612 


(4) 任何 命令 行 输入 或 输出 都 采用 如 下 所 示 的 粗 体 代码 形式 。 


$ curl -也 “X-Vault-Token: client” -X GET 
http://192.168.99.100:8200/v1/secret/client-service 


llls 
= 


(5) 本 书 还 使 用 了 以 下 两 个 图 标 。 
表示 敬告 或 重要 的 注意 事项 
人 表示 提示 或 小 技巧 。 
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第 1 章 微服 务 简介 


微服 务 是 过 去 几 年 中 IT 界 出 现 的 最 热门 趋势 之 一 。 它们 为 什么 会 日 益 受 到 欢迎 呢 ? 
要 理解 这 一 点 其 实 相 当 简 单 ， 因 为 它们 的 优点 和 缺点 都 是 众所周知 的 ， 而 所 谓 的 缺点 
却 可 以 使 用 正确 的 工具 轻松 解决 。 它 们 所 有 具有 的 优势 包括 可 扩展 性 、 灵 活性 和 独立 交 
付 ， 这 些 都 是 其 迅速 普及 的 原因 。 另 外 ， 还 有 一 些 早 期 的 IT 趋势 也 对 微服 务 的 普及 有 所 
影响 ,这 里 所 说 的 趋势 是 指 常 见 的 基于 云 的 环境 的 使 用 ,以 及 从 关系 数据 库 到 NoSQIL 的 

本 章 将 要 讨论 的 主题 包括 : 

口 “ 使 用 Spring Cloud 进行 云 原生 开发 。 


口 ”基于 微服 务 架 构 中 最 重要 的 元 素 。 
口 服务 间 通 信 模 型 。 
口上 断路 毁 和 后 备 模式 介绍 。 


1.1 微服 务 的 优点 


微服 务 (Microservices) 的 概念 定义 了 IT 系统 体系 结构 的 方法 ， 访 方法 将 应 用 程序 
划分 为 实现 业务 需求 的 松散 耦合 服务 的 集合 。 实 际 上 ， 这 是 面 回 服务 的 架构 
(Service-Oriented Architecture，SOA ) 概念 的 变 体 。 迁 移 到 基于 微服 务 的 体系 结构 的 最 
重要 的 好 处 之 一 是 能 够 连续 交付 大 型 复杂 应 用 程序 。 
截至 目前 ， 开 发 人 员 可 能 已 经 有 很 多 机 会 阅读 到 有 关 微 服务 的 书籍 或 文章 ， 大 多 数 
资料 都 会 详细 描述 它们 的 优点 和 缺点 。 在 笔者 看 来 ， 使 用 微服 务 确实 有 许多 优点 。 首 先 ， 
对 于 项 目 中 的 新 开 发 人 员 来 说 ， 微 服务 相对 较 小 且 易 于 理解 。 开 发 人 员 通 第 希望 确保 在 
一 个 地 方 执行 的 代码 修改 不 会 对 应 用 程序 的 所 有 其 他 模块 产生 不 恨 影 响 。 采 用 微服 务 之 
后 ， 开 发 人 员 对 这 一 点 可 谓 深 有 具 信 心 ， 因 为 微服 务 可 以 做 到 仅 实 现 一 个 业务 领域 ， 这 和 
一 体 化 (Monolithic 〉 应 用 程序 是 不 一 样 的 ， 一 体 化 应 用 程序 有 时 甚至 需要 将 各 种 看 似 无 
关 的 功能 和 插件 等 都 整合 到 同一 个 软件 包 里 。 当 然 ， 这 不 是 全 部 ， 笔 者 还 注意 到 ， 一 般 
来 说 ， 在 小 型 微服 务 中 维护 高 质量 代码 比 在 一 体 化 应 用 程序 中 要 容易 得 多 ， 因 为 一 体 化 
应 用 程序 通常 会 有 许多 开发 人 员 介 入 修改 。 


二 精通 Spring Cloud 微服 务 架 构 


关于 微服 务 架构 ， 值 得 器 许 的 第 二 件 事 是 其 业务 划分 。 到 目前 为 止 ， 当 开发 人 员 不 
得 不 处 理 复 杂 的 企业 系统 时 ， 总 是 会 将 系统 划分 为 子 系统 ， 而 这 个 划分 是 根据 其 他 子 系 
统 完成 的 。 例 如 ， 电 信 企 业 总 是 有 一 个 计 费 子 系统 ， 开 发 人 员 会 创建 一 个 隐藏 计 费 复杂 
性 的 子 系统 并 对 外 提供 应 用 程序 编程 接口 (Application Programming Interface，API) ， 
然后 开发 人 员 会 发 现 目 己 需要 数据 ， 但 这 些 数 据 无 法 存储 在 计 费 系统 中 ， 因 为 它 不 容易 
目 定 义 ， 所 以 开 有 人 员 需 要 再 创建 另 一 个 子 系统 ， 这 将 导致 开发 人 员 只 能 构建 一 个 复杂 
的 子 系统 网 格 ， 这 个 子 系统 网 格 很 不 容易 理解 ， 对 于 企业 中 的 新 员工 来 说 尤其 如 此 。 使 
用 微服 务 则 不 会 遇 到 这 样 的 问题 ， 如 果 它 们 设计 得 很 好 ， 那 么 每 个 微服 务 都 应 该 负责 整 
修 选 定 的 业务 领域 。 在 某 些 情况 下 ， 无 论 企 业 话 跃 的 部 门 如 何 ， 这 些 领域 都 是 相似 的 。 


1.2 使 用 Spring Framework 构建 微服 务 


尽管 微服 务 的 概念 多 年 来 一 直 是 一 个 重要 的 主题 ， 但 仍然 没有 很 多 稳定 的 框架 文 持 
运行 完整 微服 务 坏 境 所 需 的 所 有 功能 。 目 从 笔者 开始 使 用 微服 务 之 后 ， 束 一 直 在 努力 跟 
上 最 新 的 框架 并 找 出 针对 微服 务 需 求 而 开发 的 功能 。 当 然 还 有 一 些 其 他 有 趣 的 解决 方案 ， 
如 Vert.x 或 Apache Camel， 但 它们 都 不 是 Spring Framework 的 民 配 。 

Spring Cloud 实现 了 基于 微服 务 架 构 中 使 用 的 所 有 经 过 验证 的 模式 ， 如 服务 注册 表 

(Service Registries ) 、 配 置 服务 器 (Configuration Server) 、 有 断路 器 (Circuit Breakers) 、 
云 总 线 (Cloud Buses) 、OAnuth2 模式 (OAuth2 Patterns) 和 API 网 关 (API Gateways) 。 
它 拥有 强大 的 网 络 讨 论 社区 ， 因 此 其 新 功能 会 以 高 频率 发 布 。 它 基于 Spring 的 开放 式 编 
程 模 型 ， 该 模型 被 全 球 数目 万 Java 开发 人 员 使 用 。 它 也 有 编写 得 非常 优秀 的 说 明文 档 。 
在 线 得 找 许 多 可 用 的 Spring Framework 使 用 示例 时 ， 开 发 人 员 不 会 过 到 任何 问题 。 


1.3 云 原 生 应 用 程序 开发 方法 


微服 务 本 质 上 与 云 计算 平台 相关 联 ， 但 微服 务 的 实际 概念 并 不 是 什么 新 鲜 事 。 这 种 
方法 已 经 在 IT 开发 领域 应 用 了 很 多 年 ， 现 在 ， 通 过 云 解决 方案 的 普及 ， 它 已 经 发 展 到 更 
高 的 水 平 。 所 以 ， 不 难 理解 这 种 受 欢迎 程度 的 原因 。 与 企业 的 内 部 部 署 (On-Premise) 解 
决 方 案 相 比 ， 云 的 使 用 为 开发 人 员 提 供 了 可 扩展 性 、 可 靠 性 和 低 维 护 成 本 等 优点 ， 这 导 
致 云 原 生 应 用 程序 开发 方法 (Cloud-native Application Development Approach) 的 兴起 ， 
旨 在 为 开发 人 员 提 供 类 似 云 的 弹性 扩展 、 不 可 变 部 署 和 一 次 性 实例 具有 的 所 有 优势 。 这 
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一 切 都 归结 为 一 件 事 一 一 减少 满足 新 要 求 所 需 的 时 间 和 成 本 。 如 今 ， 软 件 系统 和 应 用 程 
序 正 在 不 断 改进 。 如 果 开 发 人 员 采 用 传统 的 开发 方法 ， 即 基于 一 体 化 开发 方式 ， 则 代码 
库 会 持续 增长 并 且 变 得 过 于 复杂 ， 以 至 于 无 法 进行 修改 和 维护 ， 引 入 新 功能 、 框 架 和 技 
术 也 变 得 很 难 ， 这 反 过 来 会 影 啊 创 新 并 抑制 新 想法 。 在 这 一 点 上 ， 开 发 人 员 无 疑 深 有 
同感 。 

这 枚 便 币 还 有 另 一 面 。 今 天 几乎 每 个 人 都 在 考虑 迁移 到 云端 ， 部 分 原因 是 它 显 得 很 
时 尚 。 每 个 人 都 需要 这 个 吗 ? 当然 不 是 。 那 些 不 确定 是 否 要 将 应 用 程序 迁移 到 远程 云 提 
供 商 (如 AWS、Azure 或 Google) 的 人 ， 至 少 希 望 拥 有 内 部 部 署 的 私有 云 或 Docker 容 占 
(Docker Container) 。 但 是 ， 无 论 是 迁移 到 远程 云 痛 还 是 部 署 私 有 云 服务 器 ， 都 需要 不 
小 的 成 本 开 文 ， 它 真 的 能 带 来 足够 的 好 处 吗 ? 在 讨论 云 原生 开发 和 云 平 台 之 前 ， 值 得 思 
考 这 个 问题 。 

我 并 不 是 想 阻止 开发 人 员 使 用 Spring Cloud, 恰恰 相反 ,我 们 必须 彻底 了 解 云 原生 的 
开发 才能 做 到 物 超 所 值 。 以 下 是 对 于 云 原 生 应 用 程序 开发 的 一 个 非常 好 的 定义 : 


“原生 云 应 用 程序 是 专 为 云 计算 环境 设计 的 程序 ， 而 不 是 简单 地 迁移 到 云 计算 。” 


Spring 则 在 加 速 开 发 人 员 的 云 原 生 开 发 。 使 用 Spring Boot 构建 应 用 程序 非常 快 。 本 
书 第 2 章 将 详细 介绍 如 何 做 到 这 一 点 。Spring Cloud 实现 了 微服 务 架 构 模 式 ， 并 且 可 以 帮 
助 开 发 人 员 使 用 该 领域 最 流行 的 解雇 方案。 使 用 这 些 框架 开发 的 应 用 程序 可 以 轻松 地 调 
整 为 部 署 在 Pivotal Cloud Foundry (PCF) 或 Docker 容器 上 ， 但 它们 也 可 以 按 传 统 方式 在 
一 台 或 多 台 计 算 机 上 作为 独立 进程 启动 ， 并 且 开 发 人 员 将 拥有 微服 务 方法 的 优势 。 接 下 
来 不 妨 深入 探讨 一 下 微服 务 架构 。 


1.4 了 解 微服 务 架 构 


现在 假设 有 一 个 客户 要 求 设 计 一 个 解决 方案 。 他 们 需要 某 种 银行 应 用 程序 来 保证 整 
个 系统 内 的 数据 一 致 性 。 到 目前 为 止 ， 该 客户 一 直 在 使 用 Oracle 数据 库 ， 并 且 还 购买 了 
技术 支持 。 在 不 考虑 太 多 的 情况 下 ， 我 们 可 以 选择 基于 关系 数据 模型 设计 一 个 一 体 化 应 
用 程序 。 现 在 先 来 看 一 个 系统 设计 的 简化 示意 图 ， 如 图 1.1 所 示 。 

有 4 个 实体 映射 到 数据 库 中 的 表 : 

口 第 一 个 是 客户 (Customer) 实体 ， 它 将 存储 和 检索 活动 客户 端 列 表 。 

口 “每 个 客户 可 以 有 一 个 或 多 个 账户 ， 由 账户 〈Account) 实体 操作 。 


和 过 精通 Spring Cloud 微服 务 架 构 


图 1.1 系统 设计 简化 示意 图 


口 ”转移 (Transfer) 实体 负 员 在 系统 内 的 账户 之 间 执 行 所 有 资金 转移 汇 匈 。 
口 ”还 有 一 个 产品 (Product)〉 实体 ， 创 建 该 实体 可 用 于 存储 客户 的 存 蒜 和 分 配给 客 
户 的 信用 额度 等 信息 。 

在 没有 进一步 详细 说 明 的 情况 下 ， 该 应 用 程序 公开 了 API， 该 API 提供 了 在 设计 的 
数据 库 上 实现 功能 所 需 的 所 有 操作 。 当 然 ， 该 实现 将 符合 三 层 模型 。 

一 致 性 不 再 是 最 重要 的 要 求 ， 它 甚至 不 是 强制 性 的 。 客 户 需 要 一 个 解决 方案 ， 但 并 
不 希望 这 个 解决 方案 的 开发 强行 要 求 重 新 部 署 整个 应 用 程序 。 它 应 该 是 可 扩展 的 ， 并 且 
应 该 能 够 轻松 扩展 新 的 模块 和 功能 。 此 外 ， 客 户 也 不 会 同和 开发 人 员 施 加 压力 ， 要 求 他 们 
必须 使 用 Oracle 或 其 他 关系 数据 库 不 仅 如 此 ， 他 还 乐于 避免 使 用 它 。 这 些 理由 足以 
决定 迁移 到 微服 务 吗 ? 我 们 假设 已 经 足够 。 接 下 来 ， 开 发 人 员 可 以 将 一 体 化 应 用 程序 划 
分 为 4 个 独立 的 微服 务 ， 每 个 微服 务 都 有 一 个 专用 的 数据 库 。 在 菜 些 情况 下 ， 它 仍然 可 
以 是 关系 数据 库 ， 而 在 其 他 情况 下 ， 它 也 可 以 是 NoSQL 数据 库 。 现 在 ， 我 们 的 系统 包含 
许多 独立 构建 的 服务 ， 并 将 在 我 们 的 环境 中 运行 。 随 着 微服 务 数量 的 增加 ， 系 统 复杂 性 
也 在 不 断 提 高 。 我 们 希望 隐藏 外 部 API 客户 问 的 复杂 性 ， 外 部 API 客户 端 不 应 该 知道 它 
与 服务 和 而 不 是 服务 Y 进行 通信 。 网 关 负 责 将 所 有 请 求 动态 路 由 到 不 同 的 问 点 。 在 这 里 ， 
动态 (Dynamically) 一 词 意 味 着 它 应 该 基于 服务 发 现 (Service Discovery) 中 的 条 目 ， 本 


第 1 章 ”微服 务 人 简介 “7。 


章 后 面 的 第 1.4.1 节 “ 理 解 服务 发 现 的 必要 性 ”将 对 此 有 详细 的 讨论 。 

隐藏 特定 服务 或 动态 路 由 的 调用 并 不 是 API 网 关 的 唯一 功能 。 由 于 它 是 我 们 系统 的 
入 口 点 ， 因 此 它 可 以 是 跟踪 重要 数据 、 收 集 请 求 的 指标 性 数据 以 及 计算 其 他 统计 数据 的 
好 地 方 。 它 可 以 丰富 请 求 头 〈Request Header) 或 啊 应 头 (Response Header) ， 以 便 包 含 
可 供 系 统 内 应 用 程序 使 用 的 其 他 一 些 信 息 。 它 应 该 执行 一 些 安全 操作 ， 如 身份 验证 和 授 
权 , 并 且 应 该 能 够 检测 每 个 资源 的 需求 并 拒绝 不 满足 它们 的 请 求 。 如 图 1.2 所 示 就 是 这 样 
一 个 系统 示例 ， 它 由 4 个 独立 的 微服 务 组 成 ， 它 们 对 于 在 API 网 关 后 面 的 外 部 客户 端 来 
说 是 隐藏 的 。 


图 1.2 微服 务 和 API 网 关 组 成 示意 图 


1.4.1 理解 服务 发 现 的 必要 性 


现在 假设 开发 人 员 已 经 将 一 体 化 应 用 程序 划分 为 更 小 的 独立 服务 。 从 外 部 看 ， 我 们 
的 系统 看 起 来 仍然 和 以 前 一 样 ， 因 为 它 的 复杂 性 隐藏 在 API 网 关 之 后 。 实 际 上 ， 目 前 的 
微服 务 并 不 算 多 ， 但 以 后 也 可 能 会 有 更 多 。 此 外 ， 每 个 微服 务 都 可 以 与 其 他 微服 务 交 互 。 


“8. 精通 Spring Cloud 微服 务 架 构 


这 意味 着 每 个 微服 务 都 必须 保留 有 关 其 他 微服 务 的 网 络 地 址 的 信息 。 保 持 这 样 的 配置 可 
能 非 间 及 烦 ， 特 别 是 当 涉 及 手动 缆 羡 每 个 配置 时 。 如 果 这 些 地址 在 重 局 后 动态 变化 了 该 
怎么 办 ? 图 1.3 显示 了 我 们 的 示例 微服 务 之 间 的 调用 路 由 。 


图 1.3 示例 微服 务 之 间 的 调用 路 由 示意 图 


服务 发 现 (Service Discovery) 可 以 目 动 检测 这 些 设备 在 计算 机 网 络 上 提供 的 设备 和 
服务 。 在 基于 微服 务 架 构 的 情况 下 ， 这 是 必要 的 机 制 。 局 动 后 的 每 个 服务 都 应 该 在 一 个 
中 心 位 置 注 册 ， 这 个 中 心 位 置 可 以 由 所 有 其 他 服务 访问 。 注 册 键 (Registration Key) 应 该 
是 服务 或 标识 符 的 名 称 ， 在 整个 系统 中 必须 是 唯一 的 ， 以 便 其 他 微服 务 能 够 使 用 该 名 称 
查找 和 调用 该 服务 。 具 有 给 定名 称 的 每 个 键 都 分 配 了 一 些 值 。 在 最 常见 的 情况 下 ， 这 些 
属性 (Attribute) 将 指示 服务 的 网 络 位 置 。 更 准确 地 说 ， 它 们 表示 微服 务 的 一 个 实例 ， 因 
为 它 可 以 作为 在 不 同 机 器 或 端口 上 运行 的 独立 应 用 程序 而 倍增 。 有 时 也 可 以 发 送 一 些 其 
他 信息 ， 但 这 取决 于 具体 的 服务 发 现 提 供 程 序 。 但 是 ， 这 里 重要 的 是 在 一 个 键 下 ， 可 以 
注册 同一 个 服务 的 多 个 实例 。 除 注册 外 ， 每 个 服务 还 将 获取 在 特定 发 现 服 务 器 上 注册 的 
其 他 服务 的 完整 列表 。 不 仅 如 此 ， 每 个 微服 务 都 必须 了 解 注 册 列 表 中 的 任何 更 改 。 这 可 
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以 通过 定期 更 新 之 前 从 远程 服务 器 收集 的 配置 来 实现 。 

菜 些 解决 方案 会 将 服务 发 现 的 使 用 与 服务 占 配 置 功能 相 结 合 。 当 开发 人 员 真 正面 对 
它 时 就 会 明白 ， 这 两 种 方法 非常 相似 。 通 过 服务 器 配置 ， 开 发 人 员 可 以 集中 管理 系统 中 
的 所 有 配置 文件 ,一 般 来 说 ,这样 的 配置 就 是 服务 器 作为 表述 性 状态 传递 (Representational 
State Transfer，REST) Web 服务 。 在 启动 之 前 ， 每 个 微服 务 都 会 尝试 连接 到 服务 器 并 获 
取 专 门 为 其 准备 的 参数 。 其 中 一 种 方法 是 将 这 种 配置 存储 在 版 本 控制 系统 中 一 一 如 Git 
(Git 是 目前 最 为 先进 的 分 布 式 版 本 控制 系统 ) ， 然 后 配置 服务 器 更 新 其 Git 工作 副本 并 
将 所 有 属性 作为 JSON 提供 ,在 男 一 种 方法 中 ,我 们 可 以 使 用 存储 键 值 对 (Key-Value Pairs) 
的 解决 方案 ， 并 在 服务 发 现 过 程 中 履行 提供 者 的 角色 。 最 受 欢迎 的 工具 是 Consul 和 
Zookeeper。 图 1.4 给 出 了 一 个 系统 的 架构 ， 该 系统 由 一 些 币 有 数据 库 后 问 的 微服 务 组 成 ， 
这 些 服务 在 一 个 称 为 发 现 服务 (Discovery Service) 的 中 央 服 务 中 注册 。 


1.4 示例 微服 务 均 将 在 发 现 服务 中 注册 


1.4.2 服务 之 间 的 通信 


为 了 保证 系统 的 可 靠 性 ， 开 发 人 员 不 能 允许 每 个 服务 只 有 一 个 实例 运行 的 情况 。 一 
般 来 说 ， 每 个 服务 至 少 需要 有 两 个 实例 运行 ， 以 防 其 中 一 个 实例 出 现 故障 。 当 然 ， 也 可 
能 会 有 更 多 ， 但 出 于 性 能 考虑 ， 开 发 人 员 会 保持 较 低 水 平 。 无 论 如 何 ， 同 一 服务 的 多 个 
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实例 必须 对 传 入 的 请 求 使 用 负载 均衡 。 首 先 ， 负 载 均衡 器 (Load Balancer) 通常 内 置 在 
API 网 关中 。 此 负载 均衡 器 应 从 发 现 服务 器 获取 已 注册 实例 的 列表 。 如 果 没 有 理由 不 这 
样 做 ， 那 么 开发 人 员 通 第 会 使 用 轮 询 调度 规则 〈Round-Robin Rule) 来 平衡 所 有 正在 运行 
的 实例 之 间 的 传 入 流量 为 50/50。 同 样 的 规则 也 适用 于 微服 务 端的 负载 均衡 器 。 

图 1.5 说 明了 两 个 示例 微服 务 的 多 个 实例 之 间 的 服务 间 通 信 中 所 涉及 的 最 重要 的 组 件 。 
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图 1.5 两 个 示例 微服 务 的 负载 均衡 器 


大 多 数 人 在 昕 到 微服 务 时 会 认为 它 包 含 沉 有 JSON 表示 法 的 RESTful Web 服务 ， 但 
这 只 是 其 中 一 种 可 能 性 。 我 们 可 以 使 用 其 他 一 些 交 互 方式 ， 当 然 ， 它 们 不 仅 适 用 于 基于 
微服 务 的 架构 。 应 该 执行 的 第 一 个 分 类 是 一 对 一 或 一 对 多 通信 。 在 一 对 一 交互 中 ， 每 个 
传 入 请 求 仅 由 一 个 服务 实例 处 理 ， 而 在 一 对 多 交互 中 ， 它 将 由 多 个 服务 实例 处 理 。 但 最 
注 行 的 划分 标准 则 为 调用 是 同步 的 还 是 异步 的 。 男 外 ,异步 通信 还 可 以 划分 为 通知 信息 。 
当 客 户 靖 问 服务 发送 请 求 但 不 期 望 回 复 时 ， 它 只 要 执行 一 个 简单 的 异步 调用 即 可 ， 该 异 
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步调 用 不 会 阻塞 线程 并 以 异步 方式 进行 回复 。 
此 外 , 值得 一 提 的 还 有 啊 应 式微 服务 (Reactive Microservices ) 。 从 版 本 $ 开始 , Spring 
也 已 经 文 持 这 种 类 型 的 编程 。 还 有 一 些 库 也 文 持 啊 应 式微 服务 ， 并 且 可 以 使 用 NoSQL 数 
据 库 〈 如 MongoDB 或 Cassandra) 进行 交互 。 最 后 一 个 众所周知 的 通信 类 型 是 发 布 -订阅 
(Publish-Subscribe) 。 这 是 一 对 多 交互 类 型 ， 其 中 由 客户 问 发 布 消 息 ， 然 后 由 所 有 侦 听 
服务 使 用 。 一 般 来 说 ， 此 模型 将 使 用 消 恩 代理 〈Message Broker) 实现 ， 第 见 的 消息 代理 
包括 Apache Kafka、RabbitMQ 和 ActiveMQ 等 。 


1.4.3 ”故障 和 断路 器 


前 文 已 经 讨论 了 与 微服 务 架构 相关 的 大 多 数 重要 概念 。 这 些 机 制 (包括 服务 发 现 、 
API 网 关 和 配置 服务 器 等 ) 是 帮助 开发 人 员 创 建 可 靠 且 高 效 的 系统 的 有 用 元 素 。 当 然 ， 
即使 在 设计 系统 架构 时 考虑 过 这 些 问 题 的 许多 方面 ， 开 发 人 员 也 应 该 始终 为 失败 做 好 准 
备 。 在 许多 情况 下 ， 失 败 的 原因 完全 超出 了 开发 人 员 的 控制 范围 ， 如 网 络 或 数据 库 问 题 。 
对 于 基于 微服 务 的 系统 ， 这 种 错误 可 能 特别 严重 ， 因 为 该 系统 中 的 一 个 输入 请 求 可 能 需 
要 在 许多 后 续 调 用 中 被 处 理 。 应 该 优先 考虑 的 展 好 做 法 是 在 等 等 啊 应 时 始终 使 用 网 络 起 
时 。 如 果 单 个 服务 存在 性 能 问题 ， 则 应 尽量 减少 对 其 余 服 务 的 影响 。 发 送 一 个 出 错 的 啊 
应 消息 比 长 时 间 等 待 回复， 阻塞 其 他 线程 要 好 得 多 。 

网 络 超 时 问题 的 一 个 有 趣 的 解决 方案 可 能 是 断路 器 模式 (Circuit Breaker Pattern ) 。 
这 是 一 个 与 微服 务 方法 密切 相关 的 概念 。 断 路 器 负责 计算 成 功 和 失败 的 请 求 。 如 果 错 误 
率 超过 假定 阔 值 ， 则 它 会 跳 便 《这 里 采用 了 与 电路 相关 的 概念 和 术语 ) 并 导致 所 有 进 一 
步 的 答 试 立即 失败 。 在 特定 时 间 段 之 后 ，API 客户 端 应 该 返回 发 送 请 求 ， 如 果 成 功 ， 则 
关闭 断路 右 。 如 果 每 个 服务 有 多 个 实例 可 用 ， 并 且 其 中 一 个 服务 的 工作 速度 比 其 他 服务 
慢 ， 那 么 结果 就 是 在 负载 平衡 过 程 中 忽略 了 和 它 。 处 理 部 分 网 络 故障 的 第 二 种 第 用 机 制 是 
回 退 逻辑 (Fallback Logic) ， 这 是 在 请 求 失败 时 必须 执行 的 逻辑 。 人 例如， 服务 可 以 返回 
己 绥 存 的 数据 、 默 认 值 或 空 结 果 列 表 。 束 个 人 而 言 ， 笔 者 不 是 这 个 解决 方案 的 忠实 粉丝 ， 
笔者 宁愿 将 错误 代码 传递 到 其 他 系统 ， 而 不 是 返回 已 缓存 数据 或 默认 值 。 


1 四 结 


Spring Cloud 的 一 大 优势 是 它 文 持 本 章 所 讨论 过 的 所 有 模式 和 机 制 。 与 其 他 一 些 框 染 
不 同 , 它们 也 是 稳定 的 实现 ,在 本 书 第 3 章 “ Spring Cloud 概述 ”中 将 详细 介绍 Spring Cloud 
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项 目 所 文 持 的 模式 。 

本 章 讨 论 了 与 微服 务 架 构 相 关 的 最 重要 的 概念 ， 如 云 原生 应 用 程序 开发 、 服 务 发 现 、 
分 布 式 配置 、API 网 关 和 断路 器 模式 等 。 本 章 还 以 企业 应 用 程序 的 开发 为 例 ， 提 出 了 对 
这 种 方法 的 优 缺 点 的 看 法 。 然 后 , 在 第 1.4 节 中 描述 了 与 微服 务 相 关 的 主要 模式 和 解决 方 
案 。 其 中 一 些 是 众所周知 的 模式 ， 它 们 已 经 存在 多 年 ， 但 仍 在 某 种 程度 上 被 视 为 IT 世界 
的 新 事物 。 在 本 小 结 中 ， 我 们 要 强调 的 是 ， 微 服务 本 质 上 是 云 原 生 的 。 也 就 是 说 ， 它 天 
然 地 适应 云 平 台 开 发 模式 。Spring Boot 和 Spring Cloud 等 框架 都 可 以 帮助 开发 人 员 加 速 
云 原 生 开 发 。 

迁移 到 云 原 生 开 发 的 主要 动机 是 能 够 在 保持 高 质量 的 同时 更 快 地 实现 和 交付 应 用 程 
序 。 在 许多 情况 下 ， 微 服务 都 可 以 帮助 开发 人 员 实 现 这 一 目标 ， 但 有 时 一 体 化 应 用 程序 
方法 也 并 不 是 一 个 精 糕 的 选择 。 

虽然 微服 务 是 小 而 独立 的 单元 ， 但 它们 是 集中 管理 的 。 诸 如 网 络 位 置 、 配 置 、 日 志 
文件 和 指标 等 信息 都 应 该 存储 在 一 个 中 心 位 置 。 有 各 种 类 型 的 工具 和 解决 方案 可 以 提供 
所 有 这 些 功能 。 本 书后 面 的 几乎 所 有 章节 都 将 详细 讨论 它们 。Spring Cloud 项 目 旨 在 帮助 
开发 人 员 整 合 所 有 内 容 。 袁 心 硕 望 本 书 所 提供 的 内 容 能 够 有 效 地 帮助 读者 掌握 Spring 
Cloud 。 
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据 笔者 所 知 ， 从 未 接触 过 Spring Framework 的 Java 开发 人 员 可 谓 究 究 无 几 。 实 际 上 ， 
Spring Framework 是 由 许多 项 目 组 成 的 , 它 可 以 与 许多 其 他 框架 一 起 使 用 , 开发 人 员 人 述 早 
都 将 被 迫 尝 试 使 用 它 。 虽 然 Spring Boot 的 应 用 经 验 相当 不 常见 ， 但 它 很 快 就 获得 了 很 高 
的 人 气 。 与 Spring Framework 相 比 ，Spring Boot 是 一 个 相对 较 新 的 解决 方案 。 它 的 实际 
版 本 是 2， 而 不 是 Spring Framework 的 5。 那么 ,创建 它 的 目的 是 什么 ”使 用 Spring Boot 
与 使 用 标准 Spring FrameWork 方式 运行 应 用 程序 客 竟 有 什么 区 别 呢 ? 

本 章 将 要 讨论 的 主题 包括 : 

口 ”使 用 启动 器 以 启用 项 目的 其 他 功能 。 

使 用 Spring Web 库 实现 公开 REST API 方法 的 服务 。 

使 用 属性 和 YAML 文件 自 定 义 服务 配置 。 

详细 说 明 并 提供 公开 的 REST 奖 点 的 规范 。 

配置 运行 状况 检查 和 监控 功能 。 

使 用 Spring Boot 配置 文件 以 使 应 用 程序 适应 不 同 模式 运行 。 
使 用 ORM 功能 与 嵌入 式 和 远程 NoSQL 数据 库 进 行 交互 。 


ob DO 


2.1 关于 Spring Boot 


Spring Boot 专门 用 于 运行 独立 的 Spring 应 用 程序 。 它 与 简单 的 Java 应 用 程序 一 样 ， 
使 用 java -jar 命令 。 使 Spring Boot 与 标准 Spring 配置 不 同 的 基本 原因 是 简单 性 
(CSimplicity) 。 这 种 简单 性 与 我 们 需要 了 解 的 第 一 个 重要 术语 密切 相关 ， 即 局 动 嚣 
(CStarter) 。 局 动 器 是 一 个 可 以 包含 在 项 目 依赖 项 中 的 工件 (Artifact)。 它 只 是 为 必须 包 
含 在 应 用 程序 中 的 其 他 工件 提供 一 组 依赖 项 (Dependency) ， 以 实现 所 需 的 功能 。 以 这 
种 方式 提供 的 包 可 以 使 用 ， 这 意味 着 开发 人 员 不 必 配 置 任何 东西 即 可 使 其 工作 。 这 融 来 
了 与 Spring Boot 相关 的 第 二 个 重要 术语 : 目 动 配置 (Auto-Configuration〉。 启 动 器 包含 
的 所 有 工件 都 具有 默认 设置 ， 可 以 使 用 属性 或 其 他 类 型 的 启动 器 轻松 覆盖 。 例 如 ， 如 果 
开发 人 员 在 革 个 应 用 程序 的 依赖 项 中 包含 spring-boot-starter-web， 则 它 会 对 入 一 个 默认 
Web 容器 , 并 在 应 用 程序 启动 期 间 在 默认 端口 上 局 动 它 。 继 续 深 入 了 解 可 知 ，Spring Boot 
中 的 默认 Web 容器 是 Tomcat， 它 从 端口 8080 开始 。 开 发 人 员 可 以 通过 声明 应 用 程序 属 
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性 文件 中 的 指定 字段 来 轻松 更 改 此 端口 ， 甚 至 还 可 以 通过 在 项 目 依赖 项 中 包含 spring- 
boot-starter-jetty 或 spring-boot-starter-undertow 来 更 改 Web 容器 。 

关于 Starter， 也 就 是 启动 器 ， 这 里 还 是 有 必要 再 多 介绍 一 些 。 它 们 的 官方 命名 模式 
是 Spring-boot-starter- *， 其 中 ，* 就 是 指 特定 类 型 的 启动 器 。Spring Boot 中 有 很 多 可 用 的 


局 劫 项， 本 广 将 仅 选 取 一 些 最 


受 欢迎 的 局 动 器 进行 简要 介绍 ( 见 表 2.1) ， 这 些 司 动 嚣 也 


将 应 用 于 本 书后 面 章节 所 提供 的 示例 中 。 


名 称 


sprine-boot-starter 
spring-boot-starter-web 


sprine-boot-starter-letty 


sprine-boot-starter-undertow 


spring-boot-starter-tomcat 


spring-boot-starter-actuator 


sprineg-boot-starter-Jdbec 
sprine-boot-starter-data-1pa 


spring-boot-starter-data-moneodb 


spring-boot-starter-securlty 
sprineg-boot-starter-test 


spring-boot-starter-amqp 


如 果 开发 人 员 对 可 用 启动 器 的 完整 列表 感 兴 


表 2.1 常见 启动 器 
说 。 有明 

核心 局 动 程序 ， 包 括 上 自动 配置 支持 、 日 志 记 录 和 了 AML 
允许 开发 人 员 构 建 Web 应 用 程序 ， 包 括 RESTful 和 Spring MVC。 
使 用 Tomcat 作为 默认 骨 入 式 容器 
在 项 目 中 包含 Jetty 并 将 其 设置 为 默认 的 散 入 式 servlet 容器 
在 项 目 中 包含 Undertow， 并 将 其 设置 为 默认 的 藤 入 式 servlet 容器 
包含 Tomecat 作为 甬 入 去 servlet 容器 .可 以 通过 spring-boot-starter- 
web 使 用 默认 的 servlet 容器 局 动 器 
包含 项 目 中 的 Spring Boot Actuator, 它 提供 监视 和 管理 应 用 程序 的 
功能 
包含 带 有 Tomcat 连接 池 的 Spring JBDC。 特 定数 据 库 的 驱动 程序 
应 由 开发 人 员 目 己 提 供 
包含 使 用 人 PA/Hibemate 与 关系 数据 库 交 互 所 需 的 所 有 工件 
包含 与 MongoDB 交互 以 及 在 localhost 上 初始 化 Mongo 客户 端 连 
接 所 需 的 所 有 工件 
包含 项 目 中 的 Spring Security， 默 认 情 况 下 为 应 用 程序 启用 基本 安 
全 性 
允许 使 用 JUnit、Hamcrest 和 Mockito 等 库 创 建 单元 测试 
包含 项 目的 Spring AMQP， 并 启动 RabbitMQ 作为 默认 的 AMQP 
代理 


， 请 参阅 Spring Boot 规范 。 现 在 ， 不 


妨 回 过 头 来 讨论 Spring Boot 与 Spring Framework 标准 配置 之 间 的 主要 区 别 。 正 如 前 文 所 
述 ， 开 发 人 员 可 以 包含 spring-boot-starter-web， 它 会 将 Web 容器 艇 入 应 用 程序 中 。 如 果 
使 用 的 是 标准 的 Spring 配置 ， 则 开发 人 员 不 会 将 Web 容器 舱 入 应 用 程序 中 ， 而 是 将 其 作 
为 WAR 文件 部 署 到 Web 容器 上 。 这 是 一 个 关键 的 区 别 ， 也 是 Spring Boot 用 于 创建 部 署 
在 微服 务 架构 中 的 应 用 程序 的 最 重要 原因 之 一 。 微 服务 的 一 个 主要 特征 是 独立 于 其 他 微 
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服务 。 在 这 种 情况 下 ， 很 明显 它们 不 应 共享 公共 资源 〈 如 数据 库 或 Web 容器 ) 。 由 此 可 
见 , 在 一 个 Web 容器 上 部 署 许 多 WAR 文件 是 微服 务 所 不 能 接受 的 模式 。 因 此 ,Spring Boot 
是 显而易见 的 选择 。 

就 个 人 而 言 ， 笔 者 在 开发 许多 应 用 程序 时 都 使 用 了 Spring Boot， 而 不 仅仅 是 在 微服 
务 坏 境 中 工作 时 。 如 果 开 发 人 员 尝 试 使 用 了 Spring Boot 而 不 是 标准 的 Spring Framework 
配置 ， 那 么 笔者 相信 他 将 再 也 不 想 回 过 头 来 使 用 标准 的 Spring Framework 配置 。 为 了 文 
持 这 个 结论 , 我 们 找到 了 一 个 有 趣 的 图 表 , 它 说 明了 Java 框架 存储 库 在 GitHub 上 的 流行 
程度 ， 其 网 址 为 https:Wredmonk.comyfryan/2017/06/22/language-framework-popularity-a- 
look-at-java-june-2017/。 开 发 人 员 也 可 以 通过 网 络 搜索 找到 最 新 的 此 类 统计 图 表 。 

接 下 来 我 们 将 具体 讨论 如 何 使 用 Spring Boot 开发 应 用 程序 。 


2.2 使 用 Spring Boot 开发 应 用 程 厅 


Management System) 。 在 这 里 ， 开 发 人 员 可 以 看 到 如 何在 Maven 和 Gradle 项 目 中 包含 
适当 工件 的 简短 片段 。 以 下 是 Maven 项 目 pom.xml 中 的 示例 片段 。 


<parent> 
<groupId>org.springframework.boot</grouplId> 
<artifactId>spring-boot-starter-parent</artifactId> 
<Version>1 .5.7.RELEASE</version> 
</parent> 
<dependenclies> 
<dependency> 
<grouplId>org .springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 


</dependency> 
</dependencies> 
使 用 Gradle， 开 发 人 员 将 不 需要 定义 父 依赖 项 。 以 下 是 build.gradle 中 的 一 个 片段 。 
Plugins f{ 


1d “org.springframework.boot’' version 1.5.1.RELEASE. 
} 
dependenclies 1 

compile(" org.springframework.boot:spring—boot-—starter— 
web:1.5.1.RELEASE") 
} 
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在 使 用 Maven 时 ， 没 有 必要 继承 spring-boot-starter-parent POM。 或 者 ， 
开发 人 员 也 可 以 使 用 以 下 依赖 关系 管理 机 制 |。 
<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.boot</grouplId> 
<artifactId>spring-boot-dependencies</artifactId> 
<Vversion>1.5.7.RELEASE</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


现在 ， 开发 人 员 所 需要 的 只 是 创建 主 应 用 程序 类 并 使 用 @SpringBootApplication 来 注 
解 它 ， 这 相当 于 联合 使 用 其 他 3 个 注解 ( Annotation ) ， 即 @Configuration 、 
@EnableAutoConfiguration 和 @ComponentScan: 


QSpringBootApplication 
Public class Application 1{ 


public static void main(Sstringl[] args) | 
SpringApplication.run (Application.class, args); 


} 


} 
一 旦 声明 了 主 类 和 spring-boot-starter-web， 则 开发 人 员 只 需要 运行 第 一 个 应 用 程序 。 
而 且 ， 如 果 开 发 人 员 使 用 了 诸如 Eclipse 或 IntelliJ 之 类 的 集成 开发 环境 (Integrated 
Development Environment，IDE〉， 则 应 该 只 运行 主 类 。 否 则 ， 必 须 像 标 准 Java 应 用 程序 
一 样 使 用 java -jar 命令 构建 和 运行 应 用 程序 。 首 先 , 开发 人 员 应 该 在 应 用 程序 构建 期 间 提 
供 负责 将 所 有 依赖 项 打包 到 可 执行 JAR 的 配置 。 这 个 可 执行 JAR 有 时 也 被 称 为 胖 JAR 
(Fat JAR) 。 如 果 在 Maven 项 目的 pom.xml 中 定义 了 spring-boot-maven-plugin， 则 会 执 
行 该 操作 。 
<build> 
<plugins> 
<plugin> 


<grouplId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
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</plugin> 
</plugins> 
</build> 


该 示例 应 用 程序 在 Tomeat 容器 上 仪 执 行 启动 Spring 坏 境 ，Tomcat 容 髓 在 端口 8080 
上 可 用 。 胖 JAR 的 大 小 约 为 14MB。 开 发 人 员 可 以 使 用 集成 开发 环境 轻松 得 看 项 目 中 包 
舍 的 库 。 这 些 都 是 基本 的 Spring 库 , 如 spring-core、 sprine-aop、spring-context, Spring Boot， 
己 经 艇 入 的 Tomcat， 用 于 日 志 记 录 的 库 如 Logback、Log4j 和 Slf4j， 此 外 还 有 用 于 JSON 
的 序列 化 (Serialization) 或 反 序列 化 (Deserialization) 的 Jackson 库 。 为 项 目 设 置 默认 的 
Java 版 本 是 一 个 很 好 的 选择 。 开 发 人 员 可 以 通过 声明 java.version 属性 在 pom.xml 中 轻松 
设 和 下 它 。 


<properties> 
<java.version>l1 .8</jJava.version> 
</properties> 
开发 人 员 可 以 通过 向 Jetty 服务 器 添加 新 的 依赖 项 来 更 改 默 认 的 Web 容器 。 
<dependency> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jetty</artifactId> 
</dependency> 


2.2.1 上 自 定义 配置 文件 


快速 创建 应 用 程序 并 且 无 须 很 大 的 工作 量 , 这 两 者 对 于 开发 人 员 来 说 其 实 是 一 回 事 ， 
但 同样 重要 的 是 能 够 轻松 日 定义 和 和 窟 新 默认 设置 。 在 这 一 方面 ，Spring Boot 可 以 派 上 用 
场 ， 提 供 文 持 配置 管理 的 机 制 。 要 日 定义 配置 ， 最 简单 的 方法 是 使 用 配置 文件 ， 然 后 将 
配置 文件 追加 到 应 用 程序 胖 JAR。Spring Boot 会 自动 检测 名 称 以 application 前 级 开头 的 
配置 文件 。 它 所 支持 的 文件 类 型 是 .properties 和 .yml。 

因此 ， 开 发 人 员 可 以 创建 诸如 application.properties 或 application.yml 之 类 的 配置 文 
件 , 甚至 包括 特定 于 配置 文件 的 文件 , 如 application-prod.properties 或 application-dev.yml。 
此 外 ,开发 人 员 还 可 以 使 用 操作 系统 环境 变量 和 命令 行 参 数 来 外 部 化 配置 ,使 用 properties 
或 YAML 文件 时 ， 它 们 应 放 在 以 下 位 置 之 一 。 

口 ”当前 应 用 程序 目录 的 /config 子 目 录 。 

口 ”当前 应 用 程序 目录 。 

口 类 路 径 /config 包 ( 例 如 ， 在 JAR 中 ) 。 
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口 ”类 路 径 根 。 

如 果 要 为 配置 文件 指定 一 个 特定 名 称 ， 而 不 是 application 或 application - {profile}， 
则 需要 在 局 动 期 间 提供 spring.config.name 坏 境 属性 。 开 发 人 员 还 可 以 使 用 spring.config. 
location 属性 ， 该 属性 包含 以 逗号 分 隔 的 目录 位 置 或 文件 路 径 列 表 。 


Java -Jar sample—spring-boot-—web.jar -spring.config.name=example 


Java ar sample— spring boot web.jar —— 

spring.config.location=classpath: /example .properties 

在 配置 文件 内 部 ， 开 发 人 员 可 以 定义 两 种 类 型 的 属性 。 前 先 ， 有 一 组 常见 的 预定 义 
Spring Boot 属性 ， 它 主要 由 来 自 spring-boot-autoconfigure 库 的 底层 类 使 用 。 其 次 ， 开 发 
人 员 还 可 以 考虑 定义 上 自己 的 目 定 义 配 置 属性 ， 然 后 使 用 @ConfigurationProperties 或 
@Value 注解 将 其 注入 应 用 程序 。 

现在 可 以 先 从 预定 义 的 属性 开始 。Spring Boot 项 目 所 文 持 的 完整 列表 可 以 在 它们 的 
说 明文 档 的 Common application properties 〈 第 见 应 用 程序 属性 ) 一 节 的 Appendix A〔 附 
录 A) 中 得 到 。 其 中 ， 大 多 数 都 特定 于 某 些 Spring 模块 ， 如 数据 库 、Web 服务 器 、 安 全 
性 模块 和 其 他 一 些 解决 方案 等 ， 但 是 也 有 一 组 核心 属性 。 束 个 人 而 言 ， 笔 者 更 喜欢 使 用 
YAML 而 不 是 properties 文件 ， 因 为 YAML 文件 更 方便 陪读， 当然， 有 具体 使 用 哪 一 种 文 
件 取 诀 于 开发 人 员 的 个 人 喜好 。 最 凋 见 的 是 履 兰 应 用 程序 名 称 之 类 的 属性 〈 该 名 称 将 用 
于 服务 发 现 和 分 布 式 配 置 管理 ) 、 网 络 服务 器 端口 、 日 志 或 数据 库 连 接 设置 。 

一 般 来 说 ，application.yml 文件 存放 在 src/main/resources 目录 中 ,然后 在 Maven 构建 
之 后 位 于 JAR 根 目 录 中 。 以 下 是 一 个 配置 文件 示例 ， 它 将 上 履 盖 默认 服务 器 端口 、 应 用 程 
序 名 称 和 日 志 记 录 属 性 。 


SeTVeT : 
port: SS{Port:2222 ] 


SpIing: 
application: 
name: irst-service 


logging: 
pattern: 
console= dl:mm: ss Sooo) Tlevel Tloderl36l — Tmsgtn” 
file: "%d{HH:mm:ss.SSS} [%thread|] 要 -Level $logger{l36} 一 smsgSsn 
level: 
org.springframework.web: DEBUG 
| 
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这 里 很 值得 称道 的 是 ， 开 发 人 员 不 必 为 日 志 记 录 配 置 定义 任何 其 他 外 部 配置 文件 ， 
如 log4j.xml 或 logback.xml。 在 之 前 的 文件 片段 中 ， 可 以 看 到 我 们 已 经 将 org.spring 
framework.web 的 默认 日 志 级 别 更 改 为 DEBUG 和 日 志 模 式 ， 并 创建 了 一 个 日 志文 件 
app.log， 放 置 在 当前 应 用 程序 目录 中 。 现 在 ， 默 认 的 应 用 程序 名 称 是 first-service， 默 认 
HTTP 端口 是 2222。 
开发 人 员 的 自 定义 配置 设置 也 应 放 在 相同 的 properties 或 YAML 文件 中 。 以 下 是 一 
个 之 有 目 定 义 属性 的 application.yml 示例 。 
name: first-service 
my : 
SETLTVEILS.: 
— dev.bar.com 
— foo.bar.com 


也 可 以 使 用 @Value 注解 注入 一 个 简单 的 属性 。 


QComponent 
public class CustomBean I 


@Value ("$ {name}") 
private String name; 


2 
} 


还 可 以 使 用 @ConfigurationProperties 注解 注入 更 复杂 的 配置 属性 。 例 如 ， 在 YAML 
文件 中 的 my.servers 属性 中 定义 的 值 列表 即 可 被 注入 java.util.List 类 型 的 目标 bean 中 。 

QConfigurationproperties (prefix="my") 

public class Confiqg 1 


private List<String> servers = new ArrayList<String> (); 


public List<String> getServers(} 1 
return this.servers: 


} 

} 
到 目前 为 止 , 我 们 已 经 设法 创建 了 一 个 简单 的 应 用 程序 ， 这 个 程序 除了 在 Tomcat 或 
Jetty 等 Web 容器 上 启动 Spring 之 外 什么 都 没 做 。 本章 的 这 一 部 分 则 在 回 开 发 人 员 展 示 使 
用 Spring Boot 启动 应 用 程序 天 发 是 多 么 简单 。 除 此 之 外 ， 我们 还 介绍 了 如 何 使 用 YAML 
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或 properties 文件 目 定 义 配 置 。 对 于 那些 喜欢 点 击 而 不 是 打字 的 人 ， 我 们 推荐 使 用 Spring 
Initializr 网 站 (https://start.spring.i0/)， 在 该 网 站 可 以 根据 自己 选择 的 选项 生成 项 目 存 根 
(Project Stub) 。 在 简单 的 站 点 视图 中 ， 开 发 人 员 可 以 选择 构建 工具 (Maven/Gradle) 、 
编程 语言 (Java/Kotlin/Groovy) 和 Spring Boot 版 本 等 ， 然 后 开发 人 员 应 该 在 Search for 
dependencies (搜索 依赖 项 〉 标 签 后 提供 使 用 该 搜索 引擎 的 所 有 必需 的 依赖 项 。 我 们 已 经 
选择 了 包括 spring-boot-starter-web， 它 在 Spring Initializr 上 标记 为 Web， 如 图 2.1 所 示 即 
为 该 网 站 的 屏幕 截图 。 单 击 Generate Project〈 生 成 项 目 ) 后 ， 包 含 生 成 的 源 代码 的 ZIP 
文件 将 下 载 到 开发 人 员 的 计算 机 上 。 此 外 ， 感 兴趣 的 开发 人 员 也 可 以 单 击 Switch to the full 
version (切换 到 完整 版 本 ) ， 这样 就 可 以 看 到 几乎 所 有 可 用 的 Spring Boot 和 Spring Cloud 

库 ， 它 们 都 可 以 包含 在 生成 的 项 目 中 。 


SPRING INITIALIZR 


Generatea Maenpnecr " With as and Spring Boot 15312 


Project Metadata Dependencies 
Artifact coordinates Add Spring Boot Starters and dependencies to your application 
Group Search for dependencies 

pl.piomin. services 


Artdifact 


Generate Project alt + 当 


Doan't know what co [ook for? Wanit more options? Switch te the full versia 


2.1 Spring Initializr 网 站 的 屏幕 截图 


既然 已 经 讨论 了 使 用 Spring Boot 构建 项 目的 基础 知识 ， 那 么 现在 正 是 为 示例 应 用 程 
序 添加 一 些 新 功能 的 最 佳 时 机 .。 


222 创建 RESTful Web 服务 


作为 第 一 步 ， 现 在 不 妨 来 创建 RESTful Web 服务 ， 回 调用 客户 端 公开 一 些 数据 。 如 
前 所 述 ， 负 责 JSON 消息 序列 化 和 反 序 列 化 的 Jackson 库 将 与 Spring-boot-starter-web 一 起 
目 动 包含 在 类 路 径 中 。 鉴 于 此 ， 开 发 人 员 不 需要 做 任何 事情 ， 只 需 声 明 一 个 模型 类 ， 然 
后 由 该 模型 类 通过 REST 方法 返回 或 用 作 参 数 。 
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以 下 是 示例 模型 类 Person。 


Public class Person 1 


private Long id; 

private String tirstName; 
private String lastName; 
private int age; 

private Gender gendery 


public Long getId() 1{ 
return id; 


} 


Public Void setlid(Long id}) I 
tno Tl Td 
} 


A 
} 


Spring Web 提供 了 一 些 可 用 于 创建 RESTful Web 服务 的 注解 。 其 中 的 第 一 个 注解 是 
@RestController， 该 注解 应 该 在 负责 处 理 传 入 HITP 请 求 的 控制 器 bean 类 上 设置 。 此 外 还 有 
(@RequestMapping 注解 , 它 通 贡 用 于 将 控制 器 方法 映射 到 HITP。 正如 下 面 的 文件 片段 所 示 ， 
它 可 以 在 整个 控制 器 关上 使 用 ， 以 设置 其 中 所 有 方法 的 请 求 路 径 。 开 发 人 员 可 以 为 具体 的 
HTTP 方法 使 用 更 具体 的 注解 ， 如 @GetMapping 或 @PostMapping。 这 里 值得 注意 的 是 ， 
(@GetMapping 与 @RequestMapping 相同 ， 它 们 都 具有 参数 method = RequestMethod.GET。 田 
外 两 个 常用 的 注解 是 @RequestParam 和 人 @@RequestBody。@RequestParam 可 以 绑 定 路 径 并 
查询 对 象 的 参数 ， 而 @RequestBody 则 可 以 使 用 Jackson 库 将 JSON 映射 到 对 象 。 

QRestController 


QRequestMapping("/person™") 
Public class PersonController 1 


private List<Person> persons = new ArrayList<>(); 
aGetMapping 
public List<Person> findAll() 1 

return persons; 


} 


RGetMapping ("/{id}") 
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public Person findBylId (dRequestParam("id") Long id) 1 
retirern Dersons.. SLrTeaml} -1iltertit > 
it= getld()l -equals (idy) tindFirst() get()s 
} 


@&PostMapping 

public Person add (lfRequestBody Person p) 1 
p-setid{(liong) {lpersons.size(})+1}})s 
persons.add (p); 
return ps 


} 


A 
} 


为 了 与 REST API 标准 兼容 ， 开 发 人 员 应 该 处 理 PUT 和 DELETE 方法。 在 其 实现 之 
后 , 开发 人 员 将 执行 所 有 创建 (Create) 、 检 索 (Retrieve) 、 更 新 (Update) 和 删除 (Delete ) 
操作 ， 如 表 2.2 所 示 。 


表 2.2 GET、POST、PUT 和 DELETE 方法 
方 。 法 说 明 
GET 返回 所 有 现 有 人 员 
GET 返回 具有 给 定 ID 的 人 员 
POST 添加 新 人 
PUT 更 新 现 有 人 员 
DELETE 使 用 给 定 的 ID 从 列表 中 删除 人 员 


以 下 是 使 用 DELETE 和 PUT 方法 的 @RestController 实现 示例 的 代码 片段 。 


QDeleteMapping{("/{id}") 

public void delete (QRequestParam("id") Long id) { 
List<Person> p = persons.stream(} .filter{(it 一 > 

it .qetId() -equals (id}}) -col lect (Col lectors: toLLrst(})}: 
persons.removeAll (p); 


} 


QPutMapping 
public void update (RequestBody Person p) 


Wh, 


Person person = persons.stream() .filterl(it 一 > 
it.getId() .equals (p.getId(})}) .findFirst() .get ()}; 
persons.set (persons.indexOf (person)}, pp): 


} 
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控制 器 的 代码 非常 简单 。 它 将 所 有 数据 都 存储 在 本 地 javautilList 中 ， 这 显然 不 是 一 
个 好 的 编程 习惯 。 当 然 ， 这 只 是 为 了 示例 需要 而 采取 的 简化 的 权宜 设置 。 在 本 章 第 2.6 
节 “ 将 应 用 程序 与 数据 库 集成 ”一 节 中 ， 还 将 详细 介绍 与 NoSQL 数据 库 集成 的 更 高 级 的 
示例 应 用 程序 。 

可 能 部 分 开发 人 员 有 SOAP Web 服务 的 开发 经 验 。 如 果 已 经 使 用 SOAP 而 不 是 REST 
创建 了 美 似 的 服务 ， 则 开发 人 员 将 为 客户 端 提 供 一 个 WSDL 文件 ， 其 中 描述 了 所 有 服务 
定义 。 糟 糕 的 是 ，REST 并 不 文 持 像 WSDL 这 样 的 标准 表示 法 (Notation ) 。 在 RESTful Web 
服务 的 初始 阶段 , 有 人 说 Web 应 用 程序 摘 述 语言 (Web Application Description Language， 
WADL) 将 执行 该 角色 。 但 实际 情况 是 ， 许 多 提供 商 〈 包 括 Spring Web) 在 应 用 程序 启 
动 后 都 不 会 生成 WADL 文件 。 

当然 ， 这 只 是 一 个 题 外 话 。 简 而 言 之 ， 我 们 已 经 完成 了 第 一 个 微服 务 ， 它 通过 HTTP 
公开 了 一 些 REST 操作 。 开 发 人 员 可 能 在 构建 胖 JAR 之 后 从 集成 开发 环境 或 使 用 java -jar 
命令 来 运行 此 微服 务 。 如 果 开 发 人 员 没 有 更 改 application.yml 文件 中 的 配置 属性 , 或 者 在 
运行 应 用 程序 时 未 设置 -Dport 选项 ， 则 可 以 在 http://localhost:2222 下 找到 它 。 为 了 让 其 他 
开发 人 员 能 够 调用 我 们 的 API， 这 里 有 两 种 选择 : 一 种 方法 是 共享 描述 其 用 法 的 文档 ; 
男 一 种 方法 是 采用 目 动 API 客户 端 生 成 的 机 制 ， 或 者 也 可 以 两 种 方法 并 行 ， 而 这 正 是 
Swagger 的 用 武之 地 。 


2.3 API 文档 


Swasgger 是 用 于 设计 、 构 建 和 详细 说 明 RESTful API 的 最 流行 的 工具 。 它 由 SmartBear 
创建 ，SmartBear 是 一 个 非常 流行 的 SOAP Web 服务 工具 SoapUI 的 设计 者 。 对 于 那些 具 
有 长 期 使 用 SOAP 经 验 的 开发 人 员 来 说 ， 这 可 能 是 一 个 很 好 的 建议 。 无 论 如 何 ， 在 使 用 
Swageger 的 情况 下 ， 开 发 人 员 可 以 使 用 表示 法 设计 API， 人 然后 从 中 生成 源 代 人 码 ; 或 者 反 过 
来 ， 可 以 从 源 代 码 开 始 ， 然 后 生成 Swagger 文件 。 在 有 了 Spring Boot 之 后 ， 开 发 人 员 可 
以 考虑 使 用 第 二 个 选项 。 


2.3.1 联合 使 用 Swagger 2 和 Spring Boot 


Spring Boot 和 Swagger 2 之 间 的 集成 将 由 Springfox 项 目 实 现 。 它 在 运行 时 会 检查 应 
用 程序 , 以 基于 Spring 配置 、 类 结构 和 Java 注解 来 推断 API 语义 。 要 将 Swagger 与 Spring 
结合 在 一 起 使 用 ， 开 发 人 员 需 要 将 以 下 两 个 依赖 项 添加 到 Maven 的 pom.xml 中 ， 并 且 使 
用 @EnableSwagger2 注解 主 应 用 程序 类 。 
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<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>2.71.0</version> 

</dependency> 

<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox—swagger—ui</artifactId> 
<Version>2.7.0</version> 

</dependency> 


在 应 用 程序 启动 期 间 ，Swagger 库 将 自动 从 源 代 人 码 生 成 API 文档 。 该 过 程 由 Docket 
bean 控制 ， 该 bean 也 将 在 主 类 中 声明 。 这 里 有 一 个 好 主意 ， 那 就 是 从 Maven 的 pom.xml 
文件 中 获取 API 版 本 。 要 获取 该 信息 ， 开 发 人 员 可 以 在 类 路 径 中 包含 maven-model 库 并 
使 用 MavenXpp3Reader 类 。 天 发 人 员 还 可 以 使 用 apiInfo 方法 设置 其 他 一 些 属性 , 如 标题 、 
作者 和 详细 说 明 等 。 默 认 情 况 下 ，Swagger 会 为 所 有 REST 服务 生成 说 明文 档 ， 包 括 由 
Spring Boot 创建 的 服务 。 开 发 人 员 应 该 将 此 说 明文 档 仅 放置 于 pl.piomin.services.boot. 
controller 包 中 的 @RestController。 


QBean 
public Docket api{() throws IOException, 2XmlPullParserException 1{ 
MavenXpp3Reader reader = new MavenXpp3Reader (); 
Model model = reader.read (new FileReader( “pom.xml" )) 7 
ApilnfoBuilder builder = new ApilnfoBuilder() 
-title("Person Service Apl Documentation”") 
-description("Documentation automatically generated") 
.Version (model .getVersion()) 
.Contact (new Contact ("Piotr Minikowski”, 
"piotrminkowski .wordpress.com", "piotr.minkowskilaqgmail.com")); 
return new Docket (DocumentationType. SWAGGER 2) .select() 
-apis(RequestHandlerSelectors.basePackage( pl .piomin.services.boot. 
controller")) 
.Paths (PathSelectors.any(})} .buildl) 
.apilinfol(builder.build(})); 


2.3.2 ”使 用 Swagger UI 测试 API 


在 应 用 程序 启动 之 后 , 即 可 在 http://localhost:2222/swagger-ui.html 位 置 看 到 API 说 明 
文档 仪表 板 (Dashboard) ， 这 是 Swagger JSON 定义 文件 的 一 个 对 用 户 更 友好 的 版 本 ， 
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并 且 它 也 是 自动 生成 的 ， 可 从 http://localhost:2222/v2/api-docs 获得 ， 如 图 2.2 所 示 。 该 文 
件 可 以 由 任何 其 他 REST 工具 (如 SoapUI) 导入 。 


default iv2iaprdocs) ™ | 


Person Service Apl Documentation 


Decumentation automatically generated 


Crealed by Pilotr Miikowski 
See more at piotrminkowski wordbress com 


liray 


补 犁 各 思 


lindByld 


2.2 Swagger API 说 明文 档 


如 果 开 发 人 员 更 喜欢 SoapUI 而 不 是 Swagger UI， 则 可 以 通过 选择 Project | Import 
Swagger (项 目 | 导入 Swagger) 来 轻松 导入 Swagger 定义 文件 。 然 后 ， 需 要 提供 一 个 文件 
地 址 ， 如 图 2.3 所 示 。 


4* Add Swagger Definition 


Add Smagger Detinitionm 
Createsa REST APLirom the specdied Swaggyger definibion 


swagger Definition: |httpy/localhost2222/v2/api-docs 


Default Media Type: application/json ] 
Definition Type: ‘®) Resource Listing 
0 API Declaration [only for Swagger 1 


图 2.3 指定 要 导入 的 Swagger 定义 文件 的 位 置 


就 个 人 而 言 ， 笔 者 更 喜欢 Swagger UI。 开 发 人 员 可 以 展开 每 个 API 方法 以 查看 其 详 
细 人 信息。 可 以 通过 提供 所 需 的 参数 或 JSON 输入 来 测试 每 个 操作 ， 然 后 单 击 Try it Out! 
( 试 一 试 ! ) 按钮 。 如 图 2.4 所 示 就 是 发 送 一 个 POST /person 测试 请 求 的 截图 。 
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Exameole Values 
"BEe": 28, 
再 生产 到 二 本章 “John"; 
“世态 i 二 才 记 "MALE™, 
"lastNane” : Seatt" 


Pararmelear contlant typa. | arelec ationipaon 


Iry Sum 


2.4 ”发 送 POST /person 测试 请 求 的 截图 
其 响应 截图 如 图 2.5 所 示 。 


“有 
"firstName”™: 
"astMame” : 
Ee : pa 

- = dn 


"Eender™: 


‘date 3 Wed, 84 Oct 29817 88:;41:24 GMT ， 

"transter-encoding : "ehunked . 

"content=type”: "application/Jjson:charset=UTF=8 
WP PP f 


图 2.5 POST /person 测试 请 求 的 响应 截图 
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2.4 Spring Boot 执行 性 功能 


仅 创 建 有 效应 用 程序 并 共享 标准 化 API 说 明文 档 并 非 我 们 的 全 部 目标 ， 特 别 是 如 果 
我 们 谈论 的 是 微服 务 ， 其 中 有 许多 独立 实体 需要 构建 一 个 托管 环境 。 因 此 ， 下 一 个 值得 
一 提 的 重要 事项 是 监控 和 收集 来 自 应 用 程序 的 指标 信息 。 在 这 方面 ，Spring Boot 也 全 程 
参与 。 项目 Spring Boot 执行 器 (Spring Boot Actuator) 提供 了 许多 内 置 端 点 (Endpoint) ， 
允许 开发 人 员 监 控 应 用 程序 并 与 之 交互 。 要 在 项 目 中 启用 它 ， 开 发 人 员 应 该 在 依赖 项 中 
包含 spring-boot-starter-actuator。 表 2.3 列 出 了 最 重要 的 Actuator 羡 点 。 


表 2.3 重要 Actuator 端点 列表 


路 径 说 了 明 

/beans 显示 应 用 程序 中 初始 化 的 所 有 Spring bean 的 完整 列表 

/env 公开 Spring 的 可 配置 环境 中 的 属性 ， 如 操作 系统 环境 变量 和 配置 文件 中 的 属性 

/health 显示 应 用 程序 健康 信息 

/info 显示 任意 应 用 程序 信息 。 例 如 ， 可 以 从 build-info properties 或 git.properties 文件 中 获取 它 


/loggers 显示 和 修改 应 用 程序 中 日 志 记 录 器 的 配置 
显示 当前 应 用 程序 的 指标 信息 ， 如 内 存 使 用 情况 、 正 在 运行 的 线程 数 或 REST 方法 啊 应 


/metrics 


时 间 
/trace 显示 跟踪 信息 (默认 情况 下 为 最 后 100 个 HTTP 请 求 ) 


可 以 使 用 Spring 配置 属性 轻松 目 定 义 端 点 。 例 如 ， 开 发 人 员 可 以 茶 用 由 默认 端点 司 
用 的 其 中 一 个 端点 。 默 认 情 况 下 ， 除 了 用 于 shutdown 之 外 的 所 有 端点 都 已 经 月 用 。 这 些 
端点 中 的 大 多 数 都 是 安全 的 。 如 果 要 从 Web 浏览 器 中 调用 它们 ， 则 应 在 请 求 头 (Request 
Header ) 中 提供 安全 凭据 或 禁用 整个 项 目的 安全 性 。 要 执行 后 者 ， 开 发 人 员 必 须 在 
application.yml 文件 中 包含 以 下 语句 : 

management: 


Secnrity: 
enabled: false 


2.4.1 应 用 信息 


在 局 动 期 间 ， 通 过 应 用 程序 日 志 可 以 看 到 项 目 可 用 的 完整 端点 列表 。 在 禁用 安全 性 
之 后 ， 开 发 人 员 可 以 在 Web 浏览 郁 中 测试 所 有 这 些 内 容 。 有 趣 的 是 ，/info 端点 在 默认 情 
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况 下 并 不 会 提供 任何 信息 。 如 果 开 发 人 员 想 要 更 改 此 设置 ， 则 可 以 使 用 3 个 可 用 的 目 动 
配置 的 InfoContributor bean 之 一 或 编写 和 目 己 的 bean。 在 这 3 个 bean 中 ， 第 一 个 bean 是 
EnvironmentInfoContributor， 它 公开 了 端点 中 的 环境 键 值 。 第 二 个 bean 是 GitInfoContributor， 
它 将 检测 类 路 径 中 的 git.properties 文件 , 然后 显示 有 关 提 交 的 所 有 必要 信息 ,如 分 文 名 称 
或 提交 ID。 最 后 一 个 bean 是 BuildInfoContributor， 它 可 以 从 META-INF/build-info. 
properties 文件 中 收集 信息 ,并 将 其 显示 在 疹 点 中 。Git 的 两 个 属性 文件 和 构建 信息 可 以 在 
应 用 程序 构建 期 间 目 动 生成 。 要 实现 这 一 点 ,开发 人 员 应 该 在 pom.xml 中 包含 git-commit- 
id-plugin 并 目 定 义 spring-boot-maven-plugin， 按 以 下 方式 生成 build-info.properties 文件 。 


<pPplugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
<eExXecUtlions> 
<EXECUt1ion> 
<goals> 
<goal>build-info</goal> 
<gqoal>repackage</goal> 
</goals> 
<Configquration> 
<additijonalProperties> 
<jJava.target>s {maven.compiler.target}</java.target> 
<time>s$ {maven.build.timestampl}</time> 
</additionalProperties> 
</configquration> 
</execution> 
</executions> 
</plugin> 
<plugin> 
<groupId>pl .projectl1l3.maven</grouplId> 
<artifactId>git—-commit-id-plugin</artifactId> 
<Configuration> 
<failOnNoGitDirectory>false</failOnNoGitDirectory> 
</configuration> 


</plugin> 
在 build-info.properties 文件 可 用 的 情况 下 ， 开 发 人 员 的 /info 将 与 以 前 略 有 不 同 。 
| 


“yr GdG 1{ 
"version™”:"1.0—SNAPSHOT", 
"va > 4 
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2.4.2 


"Target 2 8” 


"artiltact"”: "sample spring boot web", 


name ` : "sample-spring—boot—web", 


“group”:" "pl.pliomin.services", 
"time™:"2017-10—04T10:23:222" 


健康 信息 


与 /info 端点 一 样 ，/health 端点 也 有 一 些 目 动 配置 的 指示 名 。 开 发 人 员 可 以 监控 磁盘 
使 用 情况 、 邮 件 服务 、Java 消 旦 服务 (Java Message Service，JMS) 、 数 据 源 和 NoSQL 
数据 库 (如 MongoDB 或 Cassandra)〉 的 状态 等 。 如 果 从 我 们 的 示例 应 用 程序 中 检查 该 端 
点 ， 则 只 能 获得 有 关 磁 盘 使 用 情况 的 信息 。 现 在 我 们 可 以 将 MongoDB 添加 到 项 目 中 ， 以 
测试 一 个 可 用 的 健康 指标 MongoHealthIndicator。MongoDB 不 是 随机 选择 的 ， 它 对 于 我 
们 未 来 的 Person 微服 务 的 更 高 级 示例 是 有 用 的 。 要 局 用 MongoDB, 开发 人 员 需 要 将 以 下 
依赖 项 添加 到 pom.xml。 

de.flapdoodle.embed.mongo 工件 将 免责 在 应 用 程序 启动 期 间 启 动 租 入 式 数 据 库 的 实例 。 


<dependency> 


<grouplId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 


</dependency> 


<dependency> 
<grouplId>de.flapdoodle.embed</grouplId> 


<artifactId>de.flapdoodle.embed.mongo</artifactId> 


</dependency> 


现在 ，/health 端点 将 返回 有 关 磁 盘 的 使 用 情况 和 MongoDB 状态 的 信息 。 


{ 


"status™":"UP", 
"diskSpace":1 


}, 


"status": "UP"™". 

"total":499808989184,， 
"free":193956904960,， 
"threshold":10485760 


"mongo": { 


* INO. 
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"SS 七 atus":" UP" ， 


yaersion™ :nm3 .2 .2n 


} 


在 这 个 例子 中 ， 开 发 人 员 可 以 看 到 Spring Boot 自动 配置 的 强大 功能 。 除 了 为 项 目 添 
加 两 个 依赖 项 以 启用 髓 入 式 MongoDB 之 外 , 开发 人 员 不 需要 做 任何 事情 。 其 状态 已 经 上 自 
动 添加 到 /health 端点 。 它 还 有 一 个 可 立即 使 用 的 Mongo 客 忆 请 连接 ， 可 以 由 存储 库 bean 
进一步 使 用 。 


2.4.3 ”指标 信息 


众所周知 ， 天 上 不 会 掉 馅 饼 ， 所 以 ， 开 发 快速 且 简 单 不 可 能 没有 代价 ， 在 项 目 中 包 
含 一 些 额 外 的 库 之 后 ， 胖 JAR 文件 现在 大 约 有 30MB 。 使 用 其 中 一 个 目 动 配置 的 执行 器 
端点 /metrics， 开 发 人 员 可 以 轻松 检查 出 目 己 的 微服 务 堆 (Heap) 和 非 堆 (Non-Heap) 内 
存 的 使 用 情况 。 发 送 一 些 测试 请 求 之 后 ， 堆 的 使 用 量 约 为 140MB ， 非 堆 的 使 用 量 则 为 
65MB。 该 应 用 程序 的 总 内 存 使 用 量 约 为 320MB。 当 然 ， 即 使 只 是 在 使 用 java -jar 命令 启 
动 期 间 使 用 -Xmx 参数 ， 这 些 值 也 可 以 减少 一 点 。 但 是 ， 如 果 我 们 关心 生产 模式 下 的 可 靠 
工作 ， 则 不 应 该 过 多 地 减少 这 个 限制 值 。 除 内 存 使 用 外 ，/Ametrics 端点 还 将 显示 有 关 已 加 
载 类 的 数量 、 活 动 线程 数 、 每 种 API 方法 的 平均 持续 时 间 等 信息 。 以 下 是 我 们 的 示例 微 
服务 的 端点 啊 应 的 片段 。 


{ 
"mem":325484,， 
"mem.free™" :121745, 
"processors":4, 
"Instance.uptime":765785, 
"uptime":7715049, 
"heap.committed":260608, 
"heap.1init"™":131072, 
"heap .used":138862, 
"neap":1846272, 
"nonheap.committed" :75264, 
"nonheap.init":2496, 
"nonheap.used" :64876, 
"threads .peak":28, 
"threads.totalSsStarted":33, 
"threads":28, 
"classes":9535, 
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"classes.loaded" :9535 ， 
"gauge .response.person":7.0, 
"counter.status .200 .person":4, 
本 

} 


开发 人 员 可 以 创建 自己 的 自 定 义 指 标 。Spring Boot Actuator 提供 了 两 个 类 ， 以 方便 
想 要 这 样 做 的 开发 人 员 : CounterService 和 GaugeService。 

CounterService， 字 面 意思 是 “计数 器 服务 ”， 顾 名 思 义 ， 它 公开 了 值 的 递增 、 递 减 
和 重 置 的 方法 。 相 比 之 下 ，GaugeService 仅 用 于 提交 当前 值 。API 方法 调用 统计 信息 的 默 
认 指标 有 点 不 完善 ， 因 为 它们 仅 基 于 调用 路 径 。 如 果 方 法 类 型 在 同一 路 径 上 可 用 ， 则 无 
法 区 分 它们 。 在 我 们 的 示例 端点 中 , 这 适用 于 GET /person、POST /person 和 PUT /person。 
无 论 如 何 ， 笔 者 已 经 创建 了 PersonCounterService bean， 它 可 以 统计 add 和 delete 方法 调 
用 的 次 数 。 

QSerVvice 


public class PersonCounterService 1 
private final CounterService counterService? 


@Autowired 
Public PersonCounterService (CounterService counterService) 1 
this.counterService = counterServicer 


} 


public Vvold countNewPersons() 1 
this.counterService.increment ("services.person.add™}); 


} 


Public voijid countDeletedPersons() 1{ 
this.counterService.increment ("services.person.deleted™); 
} 
} 
需要 将 此 bean 注入 我 们 的 REST 控制 占 bean， 并且 可 以 在 添加 或 删除 人 员 时 调用 递 
增 计数 右 值 的 方法 。 


public class PersonController 1 


RAUutowired 
PersonCounterService counterService; 


ee 
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@PostMapping 

public Person add (lfRequestBody Person p) 1 
p.setIid((long) (persons.size(})+1)); 
persons.add (p); 
counterService.countNewPersons ();} 
return ps 


} 


DeleteMapping ("/{iqd}") 
public void delete (QRequestParam("id") Long id) { 
List<Person> p = persons.stream(} .filter(it 一 > 
it.getId() .equals (id)}) .collect (Collectors .toList()).; 
persons.removeAll (p}); 
counterService.countDeletedPersons(}; 


} 
现在 ， 如 果 再 次 显示 应 用 程序 的 指标 信息 ， 则 开发 人 员 将 在 JSON 响应 中 看 到 以 下 
两 个 新 的 字段 。 


“COUnEeT -SeITVvICes-person-acdd :4， 
“COUnNnter.services.person-.deleted” :3 
} 


Spring Boot 应 用 程序 生成 的 所 有 指标 信息 都 可 以 从 内 存 缓冲 区 中 导出 ， 然 后 放 到 可 
以 分 析 和 显示 它们 的 位 置 。 例 如 ， 开 发 人 员 可 以 将 它们 存储 在 Redis、Open TSDB、Statsd 
甚至 InfluxDB 中 。 

以 上 就 是 本 章 想 要 告诉 开发 人 员 的 关于 内 置 监视 器 端点 的 所有 细节 。 本 节 已 经 为 说 
明文 档 、 指 标 和 运行 状况 检查 等 主题 指定 了 相对 大 量 的 空间 ， 在 我 们 看 来 ， 这 些 是 微服 
务 开发 和 维护 的 重要 方面 。 开 发 人 员 通 第 不 关心 这 些 机 制 是 否 能 得 到 很 好 的 实现 ， 但 其 
他 人 通常 只 是 通过 这 些 指标 、 运 行 健康 状况 检查 和 应 用 程序 的 日 志 质 量 等 反映 出 来 的 现 
象 来 了 解 我 们 的 应 用 程序 。Spring Boot 提供 了 一 种 现成 可 用 的 实现 ， 因 此 开发 人 员 不 必 
花费 太 多 时 间 即 可 启用 它们 。 


2 5 开发 省 工 具 


Spring Boot 为 开发 人 员 提 供 了 一 些 其 他 有 用 的 工具 。 在 我 们 看 来 ， 非 常 好 的 是 ， 只 
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要 项 目 类 路 径 上 的 文件 发 生变 化 ， 应 用 程序 就 会 日 动 重 启 。 如 果 开 发 人 员 使 用 Eclipse 作 
为 集成 开发 环境 ， 那 么 启用 它 的 唯一 方法 是 将 spring-boot-devtools 依赖 项 添加 到 Maven 
的 pom.xml 中 。 然 后 ， 尝 试 更 改 其 中 一 个 类 中 的 茶 些 内 容 并 保存 ， 这 样 应 用 程序 就 会 自 
动 重 局 ， 并 且 它 所 花 的 时 间 比 标准 方式 停止 和 启动 要 少 得 多 。 当 启动 上 述 示 例 应 用 程序 
时 ， 大 约 需 要 9 秒 ， 而 自动 重 局 仅 需 3 秒 。 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
<optional>true</optional> 
</dependency> 
如 果 在 友 生 更 改 时 不 震 要 触发 重 司 ， 则 可 以 排除 茶 些 资源 。 默 认 情 况 下 ， 指 加 文件 
夹 的 类 路 征 上 可 用 的 任何 文件 的 更 改 都 将 会 被 纳入 监控 ， 甚 至 还 包括 静态 资源 或 视图 模 
板 ， 但 是 这 些 都 不 需要 重新 启动 。 例 如 ， 如 果 将 它们 放 在 静态 文件 夹 中 ， 则 可 以 通过 将 
以 下 属性 添加 到 application.yml 配置 文件 来 排除 它们 。 
SPpIing: 
devtools: 
restart: 
exclude: static/** 


2.6 ”将 应 用 程序 与 数据 库 集成 


在 Spring Boot 规范 中 还 可 以 找到 更 多 有 趣 的 功能 。 虽 然 笔 者 很 想 花 更 多 的 时 间 来 描 
述 该 框架 提供 的 其 他 很 好 的 功能 ， 但 还 是 不 应 该 偏离 本 章 的 主题 一 一 使 用 微服 务 的 
Spring。 在 前 文中 己 经 提 过 ， 通 过 在 项 目 中 包含 甬 入 式 MongoDB， 本 节 将 同 开 发 人 员 提 
供 一 个 更 高 级 的 微服 务 示例 。 在 开始 具体 的 讨论 之 前 ， 不 妨 回 顾 一 下 当前 版 本 的 应 用 程 
序 。 它 的 源 代 码 可 以 在 笔者 的 公共 GitHub 账户 上 找到 。 开 发 人 员 可 以 将 以 下 Git 存储 库 
克隆 到 本 地 计算 机 。 

https://eithub.com/piomimyv'sample-sprine-boot-web .git。 

基本 示例 在 master 分 文中 可 用 。 包 含 租 入 式 MongoDB 的 更 高 级 示例 将 提交 给 mongo 
分 文 。 如 果 开 发 人 员 想 尝试 运行 更 高 级 的 示例 ， 则 需要 使 用 git checkout mongo 切换 到 该 
分 文 。 现在， 我 们 需要 在 模型 类 中 执行 一 些 更 改 ， 以 启用 映射 到 MongoDB 的 对 象 。 模 型 
类 必须 使 用 @Document 注解 ， 主 键 字段 (Primary Key Field) 则 使 用 @Id 注解 。 本 示例 还 
将 ID 字段 类 型 从 Long 更 改 为 String， 因 为 MongoDB 将 会 以 UUID 格式 生成 主键 ， 如 
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$59d63385206b6d14b85S4a43c。 


QDocument (col lection = "person™) 
Public class Person |{ 


&Id 
Brivate. String ds 


private String iirstName; 
private String lastName; 
private int age; 

private Gender gender; 


public String getIGd() 1 
return Tds 


} 

public void setIid(string 1id) 1 
this.1id = 1d; 

} 

2 

} 

下 一 步 是 创建 一 个 扩展 MongoRepository 的 存储 库 接口 。MongoRepository 提供 了 搜 
索 和 存储 数据 的 基本 方法 ， 如 findAll、findOne、save 和 delete。Spring Data 有 一 个 非 种 
智能 的 机 制 ， 用 于 使 用 存储 库 对 象 执行 查询 。 开 发 人 员 不 必 目 己 实 现 碍 询 ， 只 要 定义 具 
有 正确 名 称 的 接口 方法 即 可 。 该 方法 的 名 称 应 具有 前 级 fndBy， 然 后 是 搜索 的 字段 名 称 。 
它 可 能 以 标准 搜索 关键 字 后 缀 结束， 如 GreaterThan、LessThan、Between、Like 等 。Spring 
Data 类 将 基于 完整 的 方法 名 称 目 动 生 成 MongoDB 查询 。 

相同 的 关键 字 也 可 以 与 delete...By 或 remove...By 一 起 使 用 ， 以 创建 删除 查询 。 在 
PersonRepository 接口 中 ， 可 以 定义 两 个 得 找 方法 。 其 中 ， 第 一 个 是 findByLastName， 它 
将 选择 具有 给 定 lastName 值 的 所 有 Person 实体 ; 第 二 个 是 fndByAgeGreaterThan， 它 将 
检索 年 龄 大 于 给 定 值 的 所 有 Person 实体 。 


Public interface PersonRepository extends MongoRepository<Person, String> 1 


public List<Person> findByLastName (String lastName); 
public List<Person> findByAgeGreaterThan (int age); 
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应 将 存储 库 注 入 REST 控制 器 类 。 然 后 ， 开 发 人 员 最 终 可 以 调用 PersonRepository 提 
供 的 所 有 必需 的 CRUD 方法 。 


QAutowired 

private PersonRepository repository; 
QAutowired 

private PersonCounterService counterService; 


QGetMapping 


public List<Person> findAll(} { 
return repository.findAll()}):; 


QGetMapping ("/{iqd}") 
public Person findBRById (GRequestParam("id") string id) 1 


return repository.findone (1d}); 


QPostMapping 

public Person add (GRequestBody Person p) 1 
p = repository.save (p}; 
counterService.countNewPersons ()}; 


return Bs 


QDeleteMapping ("/{id}") 

public void delete (QRequestParam("id") String id) 1 
repository-delete(id}; 
counterService.countDeletedPersons (}; 


} 
我 们 还 为 PersonRepository bean 中 的 自 定义 查找 操作 添加 了 两 个 API 方法 。 


dGetMapping("/lastname/{lastName}") 
Public List<Person> findByLastName (GRequestParam("lastName") String 
JastName) 1 


return repository.findByLastName (lastName); 
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@GetMapping("/age/ {age}") 

public List<Person> findByMgeGreaterThan (RequestParam("age") int age) 1 

return repository.findByAgeGreaterThan (age) : 

} 

以 上 就 是 本 示例 必须 要 做 的 一 切 。 我 们 的 微服 务 公 开 了 在 艇 入 的 Mongo 数据 库 上 实 
现 CRUD 操作 的 基本 API 方 法， 并 且 它 已 准备 好 启动 。 读 者 可 能 已 经 注意 到 ， 它 并 不 需 
要 我 们 创建 大 量 源 代码 。 使 用 Spring Data 实现 与 数据 库 ( 无 论 是 关系 数据 库 还 是 NoSQL) 
的 任何 交互 都 是 快速 且 相 对 容易 的 。 除 此 之 外 ， 我 们 还 面临 着 男 一 个 挑战 。 虽 然 租 入 式 
数据 库 是 一 个 不 错 的 选择 ， 但 它 仅 限 于 开发 模式 或 单元 测试 ， 而 不 是 在 生产 环境 中 。 如 
果 必 须 在 生产 模式 (Production Mode) 下 运行 微服 务 ， 则 可 能 会 局 动 一 个 独立 实例 或 部 
署 为 分 片 集群 (Sharded Cluster) 的 Mongo 实例 ， 并 将 应 用 程序 连接 到 它们 。 出 于 本 示例 
目的 ， 我 们 将 使 用 Docker 运行 MongoDB 的 单个 实例 。 

@@ 注意 : 

如 果 开 发 人 员 不 熟悉 Docker, 则 可 以 在 本 地 或 远程 计算 机 上 安装 Mongo. 有 关 Docker 
的 更 多 信息 ， 开 发 人 员 还 可 以 参考 本 书 第 14 章 “Docker 支持 ”， 其 中 包含 了 对 于 Docker 
的 简要 介绍 。 在 该 章 中 ， 开 发 人 员 将 找到 所 需 的 一 切 ， 例 如 ， 如 何在 Windows 上 安装 它 
并 使 用 基本 命令 。 为 了 后 续 章 节 的 讨论 主题 , 我 们 还 将 在 示例 实现 中 使 用 Docker， 所 以 ， 
如 果 开 发 人 员 等 握 了 与 Docker 相关 的 基础 知识 ， 那 么 将 会 方便 很 多 。 


2.7 运行 应 用 程序 


现在 来 使 用 Docker 的 run 命令 启动 MongoDB。 


docker run -d --name mongo -p 27017:27017 mongo 


可 能 对 开发 人 员 很 有 用 的 东西 是 Mongo 数据 库 客户 端 。 使 用 此 功能 ， 可 以 创建 新 数 
据 库 并 为 革 些 用 户 添加 凭据 。 如 果 在 Windows 上 安装 了 Docker， 则 其 默认 的 虚拟 机 地 址 
为 192.168.99.100。 由 于 在 run 命令 中 设置 了 -p 参数 , 所 以 Mongo 容器 的 端口 27017 已 公 
开 。 事 实 上 ， 开 发 人 员 不 必 创 建 数据 库 ， 因 为 在 定义 客户 端 连接 时 需要 提供 数据 库 的 名 
称 ， 如 果 该 数据 库 不 存在 ， 那 么 它 将 上 日 动 创建 一 个 ， 如 图 2.6 所 示 。 

接 下 来 ， 应 该 为 具有 足够 权限 的 应 用 程序 创建 用 户 ， 如 图 2.7 所 示 。 
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Add Connection 


LONMEctlon 


Eonnection 
Narme 


Hosthnarnme 


DB Name 


Read Frorm 
SECOMNDARY 


图 2.6 在 定义 客户 端 连 接 时 需要 提供 数据 库 的 名 称 
Add User 


PasswWword 


Database Delete 


图 2.7 添加 用 户 


最 后 ， 应 该 在 application.yml 配置 文件 中 设置 Mongo 数据 库 连 接 设 置 和 凭据。 


号 全 人 

Ports StoorE= 74272 
SpIring: 

application: 

name: first-service 


0 


SpIing: 
profiles: production 
application: 
name: first—-service 
data: 
mongodb: 
host: T92168.99-100 
Pet ZA011 
database: micCroservices 
username: micro 
password: micro 


Spring Boot 对 多 配置 文件 配置 有 很 好 的 支持 。 可 以 使 用 “---” 线 将 YAML 文件 分 隔 
为 一 系列 文档 , 并 对 文档 的 每 个 部 分 进行 独立 解析 。 前面 所 介绍 的 示例 与 带 有 application- 
production.yml 的 分 离 配 置 文件 完全 相同 。 如 果 在 没有 任何 其 他 选项 的 情况 下 运行 该 应 用 
程序 ， 那 么 它 将 使 用 默认 设置 ， 而 默认 设置 是 没有 配置 文件 名 称 设置 的 。 如 果 要 使 用 生 
产 属性 运行 它 ， 则 应 设置 VM 参数 spring.profiles.active。 

Java -Jar -Dspring .profiles .active=production sample-spring-boot-web-l1.0- 

SNAPSHOT .Jar 

这 还 不 是 全 部 。 现 在 ， 具 有 活动 生产 配置 文件 的 应 用 程序 无 法 局 动 ， 因 为 它 会 尝试 
初始 化 embeddedMongoServer bean。 开 发 人 员 可 能 已 经 知道 ， 绝 大 多 数 其 他 解决 方案 会 
在 Spring Boot 中 设置 了 自动 配置 ， 在 这 种 情况 下 也 没有 什么 不 同 。 所 以 ， 我 们 还 需要 在 
生产 配置 文件 中 排除 自动 配置 中 的 EmbeddedMongoAutoConfiguration 类 。 

SpIring: 

profiles: production 


用 


autoconfigure: 
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exclude: 


org .springframework.boot.autoconfigure.mongo.embedded. 
EmbeddedMongoAMAutocCconfiguration 


也 可 以 使 用 配置 类 来 排除 该 工件 。 
QConfiguration 
QProfile ("production"™) 


QEnableAutoCconfiguration (exclude = EmbeddedMongoAutoConfiguration.class) 
Public class ApplicationConfig { 

-1 
| 


当然 ， 开 发 人 员 还 可 以 使 用 更 简洁 的 解决 方案 ， 如 使 用 Maven 配置 文件 ， 并 且 从 目 
标 构 建 包 (Target Build Package) 中 排除 整个 de.flapdoodle.embed.mongo 工件 。 这 里 所 提 
出 的 解决 方案 只 是 解决 问题 的 几 种 可 能 方式 之 一 ， 但 它 显 示 了 Spring Boot 中 的 自动 配置 
和 配置 文件 机 制 。 现 在 ， 开 发 人 员 可 以 运行 该 示例 应 用 程序 并 使 用 诸如 Swagger UI 之 类 
的 用 户 界 面 来 执行 一 些 测 试 。 还 可 以 使 用 Mongo 客户 疹 连 接 到 数据 库 ， 并 检查 数据 库 中 
的 更 改 。 以 下 是 示例 项 目的 最 终 文 件 结构 。 

pl 

+— pliomin 
二 二 入 全 RES 
+ 一 二 GG 七 
+— Application.Java 


+— controller 
| 十 一 PersonController. Tava 


+— data 


| +— PersonRepository. java 


+— model 
| +- Person.Jjava 
| 1+- Gender.Jjava 


十 一 SETVLCE 


| 二 一 PersonCounterService.]Java 


示例 应 用 程序 已 经 完成 。 这 些 都 是 本 章 意 在 问 开 发 人 员 展 示 的 Spring Boot 功能 。 我 
们 所 关注 的 正 是 那些 对 创建 基于 REST 的 服务 特别 有 用 的 东西 。 
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2.8 小 结 


本 章 已 经 引导 开发 人 员 完 成 单一 微服 务 开发 的 过 程 ， 从 一 个 非常 基础 的 示例 过 渡 到 
一 个 更 高 级 的 已 经 可 用 于 生产 模式 的 Spring Boot 应 用 程序 。 本 章 详细 介绍 了 如 何 使 用 启 
动 器 为 项 目 启用 其 他 功能 ;使 用 Spring Web 库 实 现 公 开 REST API 方法 的 服务 ; 并 且 讨 
论 了 使 用 属性 和 YAML 文件 目 定 义 服务 配置 ， 解 释 了 如 何 为 已 公开 的 REST 端点 提供 详 
细 说 明文 档 和 规范 。 此 外 ， 本 章 还 配置 了 运行 状况 检查 和 健康 功能 ， 使 用 了 Spring Boot 
配置 文件 来 调整 应 用 程序 以 不 同 的 模式 运行 。 最 后 , 本 章 还 使 用 ORM 功能 实现 了 与 散 入 
式 和 远程 NoSQL 数据 库 的 交互 。 

本 章 没 有 提 到 与 Spring Cloud 有 关 的 任何 内 容 ， 这 并 非 偶然 。 如 果 没 有 使 用 Spring 
Boot 的 基本 知识 和 经 验 , 开发 人 员 束 无 法 开始 使 用 Spring Cloud 项 目 。Spring Cloud 提供 
了 许多 不 同 的 功能 ， 人 允许 开发 人 员 将 服务 放 在 基于 微服 务 的 完整 生态 系统 中 。 我 们 将 在 
接 下 来 的 章节 中 逐一 讨论 这 些 功能 。 
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在 本 书 第 1 章 “ 微 服务 简介 ”中 ， 提 到 了 云 原 生 的 开发 风格 ， 并 且 Spring Cloud 可 
以 帮助 开发 人 员 轻 松 采 用 与 此 概念 相关 的 最 佳 实践 。 实 际 上 ， 在 一 个 名 为 The 
Twelve-Factor App〔 微 服务 十 二 要 素 ) 的 趣味 倡议 中 已 经 收集 了 一 些 最 第 用 的 最 佳 实践 。 
该 倡议 App 的 访问 地 址 为 https://12factor.net/， 中 文 版 地 址 为 https:W12factornetzh cn/。 
在 该 倡议 中 开宗明义 地 提出 ， 软 件 通 常会 作为 一 种 服务 来 交付 ， 它 们 被 称 为 网 络 应 用 程 
序 ， 或 软件 即 服务 (Software as a Service，SaaS ) 。The Twelve-Factor App 为 构建 Saas 应 
用 提供 了 方法 论 ， rp be 可 在 云 平台 上 轻松 部 署 ， 并 且 可 以 
按 连 续 部 署 的 方式 交付 。 开 发 人 员 有 必要 熟悉 这 些 原 则 ， 特 别 是 ， 如 果 开 上 用 人员 上 所 构建 
的 应 用 程序 将 作为 服务 运行 的 话 ， 则 更 应 该 熟 悉 它 们 。Spring Boot 和 Spring Cloud 提供 
的 功能 和 组 件 将 使 得 开发 人 员 的 应 用 程序 可 以 符合 十 二 要 素 规则 (Twelve-Factor Rules ) 。 
开发 人 员 可 以 区 分 最 现代 的 分 布 式 系统 通 第 使 用 的 一 些 典 型 特征 。 每 一 个 遵守 十 二 要 素 
规则 的 框架 都 应 该 提供 它们 ，Spring Cloud 也 不 例外 。 

本 章 将 要 讨论 的 主题 包括 : 

口 分布 式 /版 本 化 配置 。 
路 由 。 
服务 和 服务 之 间 的 调用 。 
产 路 峰 。 
分 布 式 消息 传递 。 


DODOD DO 


3.1 从 基础 开始 


在 本 书 第 2 章 中 ， 曾 详细 介绍 了 Spring Boot 项 目的 结构 。 开 及 人 员 应 在 YAML 或 
properties 文件 中 提供 配置 ， 并 且 应 包含 应 用 程序 或 application-{profile} 名 称 。 与 标准 的 
Spring Boot 应 用 程序 相 比 ，Spring Cloud 基于 从 远程 服务 器 获取 的 配置 。 但 是 ， 应 用 程序 
内 部 仅 需 要 最 少 的 设置 ， 如 它 的 名 称 和 配置 服务 露地 址 。 这 惑 是 Spring Cloud 应 用 程序 
需要 创建 Bootstrap 上 和 下文 (Bootstrap Context) 的 原因 ， 这 个 Bootstrap 上 下 文 将 负责 从 
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外 部 源 加 载 属 性 。 
Bootstrap 属性 以 最 高 优先 级 添加 ， 并 且 本 地 配置 无 法 缆 凋 它们 。Bootstrap 上 下 文 是 
主 应 用 程序 上 下 文 的 父 级 ， 它 将 使 用 bootstrap.yml 而 不 是 application.yml。 一 般 来 说 ， 可 
以 将 应 用 程序 名 称 和 Spring Cloud Config 设置 如 下 。 
Spring: 
application: 
NAame. person—SsService 
cloud: 
config: 
uri: http://192.168.99.100:8888 
通过 将 spring.cloud.bootstrap.enabled 属性 设置 为 false， 开 发 人 员 可 以 轻松 禁用 
Bootstrap 上 下 文 司 动 。 此 外 ， 还 可 以 使 用 spring.cloud.bootstrap.name 属性 更 改 Bootstrap 
引导 程序 配置 文件 的 名 称 , 甚至 可 以 通过 设置 spring.cloud.bootstrap.location 来 更 改 其 位 置 。 
因为 这 里 也 提供 了 配置 文件 机 制 ， 所 以 开发 人 员 还 可 以 创建 诸如 bootstrap-development.yml 
之 类 的 文件 ， 并 将 其 加 载 到 活动 的 开发 配置 文件 (Development Profile) 中 。Spring Cloud 
Context 库 中 提供 了 此 功能 和 其 他 一 些 功 能 ， 它 将 作为 父 依赖 项 (Parent Dependency) 与 
任何 其 他 Spring Cloud 库 一 起 添加 到 项 目 类 路 径 中 。 在 这 些 功 能 中 , 有 一 项 是 Spring Boot 
Actuator 附带 的 一 些 额 外 管理 端点 。 
口 env: 它 是 针对 Environment 的 新 POST 方法 ， 将 执行 日 志 级 别 的 更 新 ， 并 且 重 
新 绑 定 @ConfigurationProperties。 
口 refresh: 它 将 重新 加 载 Bootstrap 上 和 下文， 并 且 刷 新 所 有 使 用 @RefreshScope 注 
解 的 bean。 
口 restart: 它 将 重新 启动 Spring ApplicationContext。 
口 pause: 它 将 停止 Spring ApplicationContext。 
口 ”resume: 它 将 启动 Spring ApplicationContext。 
和 Spring Cloud Context 一 起 使 用 的 下 一 个 库 是 Spring Cloud Commons， 它 同样 作为 
父 依赖 项 包含 在 Spring Cloud 项 目 中 。 它 将 为 诸如 服务 发 现 、 负 载 均 衡 和 断路 占 之 类 的 
机 制 提供 一 个 通用 的 抽象 层 ， 其 中 还 包括 一 些 常用 的 注解 ， 如 @EnableDiscoveryClient 或 
@LoadBalanced 等 。 后 续 章 节 将 介绍 有 关 它 们 的 详细 信息 。 


3.1.1 Netfllx OSS 


在 阅读 本 书 前 两 章 时 ， 开 发 人 员 可 能 已 经 注意 到 许多 与 微服 务 架 构 相 关 的 关键 字 的 
出 现 。 对 于 部 分 开发 人 员 来 说 ， 这 可 能 是 一 个 新 名 词 ， 而 对 于 其 他 人 来 说 ， 这 是 众 所 周 
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知 的 。 但 是 到 目前 为 止 ， 本 书 疝 未 提 及 微服 务 网 络 社区 的 一 个 重要 词汇 。 大 多 数 人 都 知 
道 ， 这 个 词 就 是 Netfix (美国 最 大 的 在 线 DVD 租赁 商 ， 中 文 名 : 奈 飞 公司 ) 。 很 多 人 都 
喜欢 该 公司 提供 的 电视 节目 和 其 他 作品 ， 但 是 对 于 开发 人 员 来 说 ， 它 是 因 其 他 原因 而 邮 
名 的 ， 这 个 原因 就 是 微服 务 。Netflix 是 最 早 从 创建 单一 的 一 体 化 应 用 程序 的 传统 开发 模 
式 迁 移 到 云 原 生 微 服务 开发 方法 的 先驱 之 一 。 该 公司 通过 将 大 部 分 源 代 码 推 送 到 公共 存 
储 库 、 在 会 议 演示 中 发 言 以 及 发 布 博客 帖 文 等 方式 来 与 网 络 社区 分 享 其 专业 经 验 。Netflix 
架构 的 概念 非常 成 功 ， 它 也 成 为 其 他 大 型 企业 的 榜样 ， 而 它 的 开 架构 师 (如 Adrian 
Cockcroft 等 ) 现在 则 是 微服 务 的 杰出 传播 者 。 此 后 ， 许 多 开源 框架 都 基于 Netflix 共享 的 
代码 提供 了 它们 的 解决 方案 库 。Spring Cloud 也 不 例外 , 它 提供 了 与 最 流行 的 Netflix OSS 
功能 的 集成 ， 这 些 功 能 包括 Eureka、Hystrix、Ribbon 和 Zuul 等 。 

顺便 说 一 句 ， 不 知道 你 是 否 一 直 关 注 Netflix， 但 他 们 对 自己 决定 开放 大 部 分 源 代码 
的 原因 做 出 了 清晰 的 转述 ， 我 认为 这 值得 引用 ， 因 为 这 也 部 分 地 解释 了 他 们 的 解决 方案 
在 IT 世界 中 大 获 成 功 和 广 受 欢迎 的 原因 : 


“ 当 我 们 说 要 将 Netflix 全 部 移植 到 云端 时 ， A 完全 疯 了 。 他 们 不 相信 
我 们 实际 上 已 经 这 样 做 了 ， 他 们 认为 我 们 只 会 把 事情 搞 砸 


3.1.2 ”使 用 Eureka 进行 服务 发 现 


Spring Cloud Netflix 提供 的 第 一 个 模式 是 使 用 Eureka 的 服务 有 现 。 该 软件 包 分 为 客 
户 端 和 服务 器 两 部 分 。 

要 在 项 目 中 包含 Eureka 客户 端 ， 开 发 人 员 应 该 使 用 相应 的 Spring-cloud-starter-eureka 
启动 器 。 客 户 端 始终 是 应 用 程序 的 一 部 分 ， 人 负责 连接 到 远程 发 现 服务 器 。 一 旦 建立 起 连 
接 ， 它 应 该 发 送 带 有 服务 名 称 和 网 络 位 置 的 注册 消 恩 。 如 果 当 前 微服 务必 须 从 男 一 个 微 
服务 调用 端点 ， 则 客户 端 应 该 从 服务 器 检索 县 有 已 注册 服务 列表 的 最 新 配置 。 服 务 占 可 
以 作为 独立 的 Spring Boot 应 用 程序 进行 配置 和 运行 ， 并 且 应 该 设 定 为 高 度 可 用 ， 每 个 服 
务 占 都 可 以 将 其 状态 复制 到 其 他 节点 。 要 在 项 目 中 包含 Eureka Server， 开 发 人 员 需 要 使 
用 spring-cloud-starter-eureka-server 局 动 露 。 


3.1.3 ”使 用 Zuul 路 由 


在 Spring Cloud Netflix 项 目下 可 用 的 下 一 个 流行 模式 是 使 用 Zuul 进行 智能 路 由 。 它 
不 仅 是 基于 JVM 的 路 由 器 ， 而 且 还 可 以 充当 服务 器 端 负载 均衡 器 或 执行 一 些 过 滤 。 它 还 
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可 以 具有 各 种 各 样 的 应 用 。Netflix 将 其 用 于 喘 份 验证 、 减 轻 负载 、 静 态 啊 应 处 理 或 压力 
测试 等 情况 。 它 与 Eureka Server 的 相同 之 处 在 于 ， 它 可 以 作为 独立 的 Spring Boot 应 用 程 
序 进行 配置 和 运行 。 

要 在 项 目 中 包含 Zuul， 需 要 使 用 spring-cloud-starter-zuul 启动 器 。 在 微服 务 架构 中 ， 
Zuul 扮演 着 API 网 关 的 重要 角色 ， 它 是 整个 系统 的 入 口 点 。 它 需要 了 解 每 个 服务 的 网 络 
位 置 ， 因 此 它 可 以 通过 将 发 现 客户 端 (Discovery Client) 包含 到 类 路 径 中 来 与 Eureka Server 
进行 交互 。 


3.1.4 ”使 用 Ribbon 实现 负载 均衡 


Spring Cloud Netflix 的 下 一 个 功能 同样 是 开发 人 员 不 能 忽视 的 , 因为 它 束 是 用 于 实现 
客户 端 人 负载 均衡 的 Ribbon。Ribbon 文 持 最 流行 的 协议 ， 如 TCP、UDP 和 HTTP 等 。 它 不 
仅 可 以 用 于 同步 REST 调用 ， 还 可 以 用 于 异步 和 反应 模型 。 除 了 负载 均衡 之 外 ， 它 还 能 
提供 与 服务 发 现 、 绥 存 、 批 处 理 和 容错 功能 等 的 集成 Ribbon 是 建立 在 基本 HITP 和 TCP 
客户 端 之 上 的 新 抽象 层次 。 

要 将 Ribbon 包含 在 项 目 中 ， 需 要 使 用 spring-cloud-starter-ribbon 局 动 占 。Ribbon 文 
持 轮 询 调度 Round Robin) 算法 、 可 用 性 过 滤 和 现成 可 用 的 加 权 啊 应 时 间 负 载 均 衡 规则 

(Weighted Response Time Load Balancing Rule) ， 并 且 可 以 使 用 目 定 义 规 则 对 其 进行 轻 
松 扩 展 。 它 将 基于 命名 客户 端 (Named Client) 概念 ， 这 意味 着 应 该 为 包含 负载 均衡 的 服 
务 器 提供 一 个 名 称 。 


3.1.5 编写 Java HTTP 客户 端 


Feign 是 一 个 受 欢 迎 程度 略 低 的 Netflix OSS 软件 包 。 它 是 一 个 声明 性 REST 客户 端 ， 
可 以 帮助 开发 人 员 更 轻松 地 编写 Web 服务 客户 端 。 使 用 Feign 之 后 ， 开 发 人 员 只 需要 声 
明和 注解 接口 ， 而 实际 的 实现 将 在 运行 时 生成 。 

要 在 项 目 中 包含 Feign， 需 要 使 用 spring-cloud-starter-feign 启动 器 。 它 可 以 与 Ribbon 
客户 端 集 成 ， 因 此 在 默认 情况 下 就 已 经 文 持 负载 均衡 和 其 他 Ribbon 功能 ， 包 插 与 发 现 服 
务 的 通信 。 


3.1.6 ”Hystrix 的 延迟 和 容错 能 ， 


在 本 书 第 1 章 “ 微 服务 简介 ”中 已 经 提 到 了 断路 器 模式 ，Spring Cloud 提供 了 一 个 实 
现 这 种 模式 的 库 。 它 基于 由 Netflix 创建 的 作为 断路 器 实现 的 Hystrix 软件 包 。 默 认 情 况 下 ， 
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Hystrix 将 与 Ribbon 和 Feign 客户 端 集成 在 一 起 。 回 退 〈EFallback) 与 断路 器 概念 密切 相 
关 。 使 用 Spring Cloud 库 ， 开 发 人 员 可 以 轻松 配置 回 退 多 辑 ， 如 果 存 在 读 取 或 断路 器 超 
时 ， 则 应 执行 该 回 退 逻辑 。 要 在 项 目 中 包含 Hystrix， 需 要 使 用 spring-cloud-starter-hystrix 
启动 占 。 


3.1.7 ”使 用 Archaius 进行 配置 管理 


Spring Cloud Netflix 项 目 提 供 的 最 后 一 个 重要 功能 是 Archaius。 就 个 人 而 言 ， 笔 者 尚 
未 使 用 过 这 个 库 ， 但 它 在 某 些 情况 下 可 能 会 很 有 用 。Spring Cloud 参考 资料 中 称 Archaius 
是 Apache Commons Configuration 项 目的 扩展 。 它 允许 通过 轮 询 (Polling) 源 的 更 改 或 将 
更 改 推送 到 客户 端 来 更 新 配置 。 


3.2 ”发现 和 分 布 式 配置 


服务 上 发现 和 分 布 式 配置 管理 是 微服 务 架 构 的 重要 组 成 部 分 。 这 两 种 不 同 机 制 的 技术 
实现 非常 相似 。 它 可 以 归结 为 将 特定 键 下 的 参数 存储 在 灵活 的 键 - 值 存储 中 。 实 际 上 ， 市 
场 上 有 知 干 种 有 趣 的 解决 方案 都 可 以 提供 这 两 种 功能 .Spring Cloud 集成 了 它们 之 中 最 有 党 
欢迎 的 产品 ， 但 是 还 有 一 个 例外 的 地 方 ， 那 就 是 Spring Cloud 只 为 分 布 式 配置 创建 了 目 
己 的 实现 。 此 功能 在 Spring Cloud Config 项 目下 可 用 。 相 比 之 下 ，Spring Cloud 没有 为 服 
务 注 册 和 发 现 提供 自己 的 实现 。 

像 往 第 一 样 ， 我 们 可 以 将 此 项 目 划分 为 服务 器 和 客户 端 文 持 。 服 务 器 是 一 个 中 心 位 
置 ， 可 以 在 所 有 环境 中 管理 应 用 程序 的 所 有 外 部 属性 。 它 可 以 在 多 个 版 本 和 配置 文件 中 
同时 维护 配置 ， 这 是 通过 使 用 Git 作为 存储 后 端 来 实现 的 。 该 机 制 非常 智能 ， 本 书 第 5 
章 “ 使 用 Spring Cloud Config 进行 分 布 式 配置 ”中 对 此 有 详细 讨论 。Git 后 端 不 是 存储 属 
性 的 唯一 选项 。 配 置 文件 也 可 以 位 于 文件 系统 或 服务 器 类 路 径 上 。 下 一 个 选项 是 使 用 
Vault 作为 后 端 。Vanult 是 一 个 开源 工具 ， 用 于 管理 HashiCorp 发 布 的 令 牌 、 密 人 码 或 证 书 等 
机 密 。 我 们 知道 ， 许 多 组 织 都 特别 关注 安全 问题 ， 例 如 ， 将 凭证 存储 在 安全 的 地 方 ， 因 
此 ， 它 可 能 是 适合 这 些 组 织 的 解决 方案 。 一 般 来 说 ， 开 发 人 员 还 可 以 管理 配置 服务 嚣 访 
问 级 别 的 安全 性 。 无 论 哪个 后 端 用 于 存储 属性 ，Spring Cloud Config Server 都 会 公开 一 个 
基于 资源 的 HITP API， 通 过 该 API 可 以 轻松 访问 和 它们。 默认 情况 下 ,该 API 将 使 用 基本 
号 份 验证 进行 保护 ， 但 也 可 以 使 用 私 钥 / 公 钥 吴 份 验证 设置 SSL 连接 。 

服务 刁 可 以 作为 独立 的 Spring Boot 应 用 程序 运行 ， 其 属性 通过 REST API 公开 。 要 
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为 项 目 启用 它 ， 开 发 人 员 应 该 添加 spring-cloud-config-server 依赖 项 。 客 户 端 也 有 文 持 。 
在 创建 任何 Spring bean 之 前 ， 每 个 使 用 配置 服务 器 作为 属性 源 的 微服 务 都 需要 在 启动 之 
后 立即 连接 到 它 。 有 趣 的 是 ， 非 Spring 应 用 程序 也 可 以 使 用 Spring Cloud Config Server。 
有 一 些 流行 的 微服 务 框 架 会 在 客户 端 与 它 集 成 。 要 为 应 用 程序 启用 Spring Cloud Config 
Client， 开 发 人 员 需 要 包含 spring-cloud-config-starter 依赖 项 。 


3.2.1 可 选 奉 代 万 案 一 一 Consul 


Netflix 发 现 和 Spring 分 布 式 配置 的 一 个 有 趣 的 替代 方案 似乎 是 由 Hashicorp 创建 的 
Consul。Spring Cloud 提供 了 与 这 一 流行 工具 的 集成 ， 以 便 用 于 在 基础 架构 中 的 发 现 和 配 
置 服务 。 像 往常 一 样 ， 开 发 人 员 可 以 使 用 一 些 简单 的 通用 注解 来 启用 该 集成 。 与 之 前 提 
供 的 解决 方案 相 比 ， 唯 一 的 区 别 在 于 配置 设置 。 为 了 与 Consul 服务 器 建立 通信 ， 其 代理 

(Agent) 需要 可 用 于 应 用 程序 。 它 必须 能 够 作为 一 个 独立 的 进程 运行 ， 默认 情况 下 ， 它 
应 该 在 http://localhost:8500 地 址 处 可 用 。 此 外 ，Consul 还 提供 了 REST API， 该 API 可 以 
直接 用 于 注册 、 收 集 服务 列表 或 属性 配置 。 

要 激活 Consul Service Discovery， 需 要 使 用 spring-cloud-starter-consul-discovery 启动 
器 。 在 应 用 程序 启动 和 注册 之 后 ， 客 户 端 应 该 会 查询 Consul 以 查找 其 他 服务 。 它 文 持 以 
下 两 种 功能 ; 使 用 Netflix Ribbon 的 客户 站 负载 均衡 磺 ， 以 及 使 用 Netflix Zuul 的 动态 路 


3.2.2 Apache Zookeeper 


Spring Cloud 文 持 的 该 领域 下 的 一 个 流行 的 解决 方案 是 Apache Zookeeper。 根 据 其 文 
档 说 明 ， 它 是 用 于 维护 配置 、 命 名 的 集中 式 服务 ， 该 服务 还 提供 分 布 式 同步 ， 并 且 能 够 
对 服务 进行 分 组 ,之 前 适用 于 Consul 的 有 关 Spring Cloud 文 持 的 所 有 内 容 对 于 Zookeeper 
来 说 也 同样 适用 。 这 里 值得 一 提 的 是 简单 的 通用 注解 ， 它 在 很 多 情况 下 都 必须 用 到 ， 例 
如 ， 启 用 集成 、 通 过 设置 文件 中 的 属性 进行 配置 ， 以 及 用 于 与 Ribbon 或 Zuul 交互 的 自动 
配置 。 

要 在 客户 端 使 用 Zookeeper 月 用 服务 友 现 ， 不 仅 需 要 包含 spring-cloud-starter- 
Zookeeper-discovery， 还 需要 包含 Apache Curator， 后 者 提供 了 一 个 API 框架 和 实用 程序 ， 
使 集成 变 得 简单 和 可 笔 。 分 布 式 配置 客户 端 不 需要 和 它 ， 开 发 人 员 只 需要 使 项 目 依赖 项 包 


舍 Spring-cloud-starter-zookeepel-config 即 可 。 
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3.2.3 ”其 他 项 目 


值得 一 提 的 还 有 男 外 两 个 项 目 ， 它 们 现在 正 处 于 月 化 阶段 。 所 有 这 些 项 目 都 可 以 在 
GitHub 存储 库 中 找到 ， 其 地 址 为 https://github.comy/spring-cloud-incubator。 其 中 一 些 可 能 
会 在 短期 内 正式 附加 到 Spring Cloud 软件 包 。 第 一 个 要 说 的 是 Spring Cloud Kubernetes， 
它 提供 了 与 这 个 非常 流行 的 工具 的 集成 。 关 于 它 我 们 有 很 多 可 以 讲述 的 东西 ， 但 为 了 简 
短 起 见 ， 这 里 不 妨 就 用 几 句 话 来 概括 。 它 是 一 个 可 以 对 容器 化 应 用 程序 (Containerized 
Application) 进行 目 动 部 署 、 扩 展 和 管理 的 系统 ， 最 初 由 Google 设计 ; 它 可 用 于 容 右 编 
排 ， 并 具有 许多 有 趣 的 功能 ， 包 括 服 务 发 现 、 配 置 管理 和 负载 均衡 等 。 在 某 些 情况 下 ， 
它 可 能 会 被 视 为 Spring Cloud 的 竞争 对 手 。 其 配置 将 随 YAML 文件 的 使 用 一 起 提供 。 

Spring Cloud 的 重要 特性 是 服务 发 现 和 分 布 式 配置 机 制 ， 这 些 机 制 都 可 以 在 Kubemetes 
平台 上 获得 。 要 在 应 用 程序 中 使 用 它们 , 开发 人 员 需 要 包含 Spring-cloud-starter-kubernetes 
局 动 占 。 

第 二 个 值得 一 提 的 处 于 孵化 阶段 的 有 趣 项 目 是 Spring Cloud Etcd。 与 上 述 项 目 一 样 ， 
其 主要 功能 是 分 布 式 配置 、 服 务 注册 和 发 现 。Etcd 不 是 像 Kubernetes 这 样 强 大 的 工具 ， 
它 只 是 提供 了 一 个 分 布 式 键 - 值 存储 ， 它 具有 在 集群 环境 中 存储 数据 的 可 靠 方 法 。 此 外 ， 
Etcd 还 是 Kubernetes 中 服务 发 现 、 集 群 状 态 和 配置 管理 的 后 端 。 


3.3 使 用 Sleuth 进行 分 布 式 跟踪 


Spring Cloud 的 男 一 个 基本 功能 是 分 布 式 跟踪 (Distributed Tracing) , 它 可 以 在 Spring 
Cloud Sleuth 库 中 实现 。 其 主要 目的 是 在 人 处理 单个 输入 请 求 时 ， 关 联 在 不 同 微服 务 之 间 分 
派 的 后 续 请 求 。 与 大 多 数 情况 一 样 ， 这 些 是 基于 HTTP 头 实现 跟 踩 机 制 的 HTTP 请 求 。 
该 实现 是 在 SIf4j 和 MDC 上 构建 的 。S1f4j 为 特定 的 日 志 杠 架 ( 如 logback、log4j 或 java. 
util.logging〉 提供 了 外 观 和 抽象 。 上 映射 诊断 上 下 文 (Mapped Diagnostic Context，MDC ) 
是 用 于 区 分 不 同 来 源 的 日 志 输 出 的 解决 方案 ， 访 解雇 方案 还 可 以 使 用 实际 范围 中 不 可 用 
的 其 他 信息 来 丰 定 日 志 输 出 。 

Spring Cloud Sleuth 可 以 将 跟 中 和 跨度 (Span) ID 添加 到 SIf4J MDC 中 ， 以便 开发 人 
员 能 够 提取 有 具有 给 定 跟 踪 或 跨度 的 所 有 日 志 。 它 还 添加 了 一 些 其 他 条 目 ， 如 应 用 程序 名 
称 或 可 导出 标志 。 它 集成 了 最 流行 的 消 恩 传递 解决 方案 (如 Spring REST 模板 、Feign 客 
户 端 、Zuul 过 滤器 、Hystrix 或 Spring Integration 消息 通道 等 ) 。 它 也 可 以 与 RxJava 或 计 
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划 任 务 一 起 使 用 。 

要 在 项 目 中 局 用 Spring Cloud Sleuth， 需 要 添加 spring-cloud-starter-sleuth 依赖 项 。 对 
于 开发 人 员 来 说 ， 基 本 跨度 和 跟 躁 ID 机 制 的 使 用 是 完全 透明 的 。 

添加 跟踪 头 并 不 是 Spring Cloud Sleuth 的 唯一 功能 。 它 还 负责 记录 计时 信息 ， 这 在 延 
述 分 析 中 很 有 用 。 这 些 统计 数据 可 以 导出 到 Zipkin， 后 者 是 一 种 可 用 于 查询 和 可 视 化 计 
时 数据 的 工具 。 
@@ 注意: 

Zipkin 是 一 种 分 布 式 跟 距 系统， 专门 用 于 分 析 微 服务 架构 中 的 延迟 问题 。 它 公开 了 
用 于 收集 输入 数据 的 HTTP 端点 。 要 为 Zipkin 生成 和 发 送 跟 踪 ， 应 该 将 spring-cloud- 
starter-zipkin 依赖 项 包含 在 项 目 中 。 


一 般 来 说 ， 没 有 必要 分 析 一 切 。 鉴 于 输入 的 流量 非常 高 ， 因 此 ， 开 发 人 员 只 需要 收 
集 一 定 比例 的 数据 。 基 于 这 个 目的 ，Spring Cloud Sleuth 提供 了 一 个 采样 策略 ， 开 发 人 员 
可 以 决定 向 Zipkin 发 送 多 少 输入 的 流量 。 解 决 大 数据 问题 的 第 二 个 智能 解决 方案 是 使 用 
消息 代理 (Message Broker) 发 送 统计 信息 ， 而 不 是 使 用 默认 的 HTTP 端点 。 要 局 用 此 功 
能 ， 必 须 包 含 spring-cloud-sleuth-stream 依赖 项 ， 它 允许 应 用 程序 成 为 消 奶 的 生产 者 ， 并 
是 发 送 到 Apache Kafka 或 RabbitMQ。 


3.4 消息 传递 和 集成 


前 文 已 经 提 到 了 消 姑 传递 代理 及 其 在 应 用 程序 和 Zipkin 服务 器 之 间 进 行 通信 的 用 
法 。 一 般 来 说 ，Spring Cloud 可 以 通过 同步 /异步 HTTP 和 消息 传递 代理 支持 两 种 类 型 的 
通信 。 该 领域 的 第 一 个 项 目 是 Spring Cloud Bus， 它 允许 开发 人 员 回 应 用 程序 发 送 广播 事 
件 ， 将 有 关 状 态 的 修改 “如 配置 属性 更 新 或 其 他 管理 命令 等 ) 通知 给 应 用 程序 。 实 际 上 ， 
开发 人 员 也 可 能 希望 使 用 具有 了 RabbitMQ 代理 的 AMQP 启动 器 或 Apache Kafka 的 启动 器 ， 
其 局 用 方法 和 前 文 所 述 是 一 样 的 ， 只 需要 将 spring-cloud-starter-bus-amdqp 或 spring-cloud- 
starter-bus-kafka 包含 在 依赖 关系 管理 中 即 可 ， 所 有 其 他 必要 的 操作 都 将 通过 自动 配置 来 
执行 。 

Spring Cloud Bus 是 一 个 相当 小 的 项 目 ， 它 允许 开发 人 员 使 用 分 布 式 消息 传递 功能 进 
行 常见 操作 ， 如 广播 配置 更 改 事件 。 但 是 ， 如 果 要 构建 由 消息 驱动 的 微服 务 组 成 的 系统 ， 
那么 正确 的 框架 选择 应 该 是 Spring Cloud Stream。 这 是 一 个 非常 强大 的 框架 , 也 是 最 大 的 
Spring Cloud 项 目 之 一 ， 本 书 专门 用 了 一 个 整 章 (第 11 章 “ 消 上 息 驱 动 的 微服 务 ”) 来 详 
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细 介 绍 它 。 与 Spring Cloud Bus 相同 , 它 有 两 个 绑 定 器 (Binder) 可 用 , 第 一 个 用 于 AMQP 
和 RabbitMQ， 第 二 个 则 用 于 Apache Kafka。Spring Cloud Stream 基于 Spring Integration 

(这 是 Spring 的 另 一 个 大 型 项 目 ) ， 它 提供 了 一 种 编程 模型 ， 文 持 大 多 数 企 业 集 成 模式 

( Enterprise Integration Pattern ) ， 如 端点 、 通 道 、 聚 合 器 (Aggregator ) 或 转换 霹 

CTransformer) 等 。 整 个 微服 务 系统 中 包含 的 应 用 程序 将 通过 Spring Cloud Stream 输入 
和 输出 通道 进行 相互 通信 。 它 们 之 间 的 主要 通信 模型 是 发 布 /订阅 (Publish/Subscribe) ， 
其 中 的 消 恩 将 通过 共 译 主题 广播 。 此 外 ， 文 持 每 个 微服 务 的 多 个 实例 也 很 重要 。 在 大 多 
数 情 况 下 ， 消 息 应 仅 由 单个 实例 处 理 ， 而 发 布 /订阅 模型 不 文 持 单个 实例 ， 这 就 是 为 什么 
Spring Cloud Stream 引入 了 分 组 机 制 ， 在 该 机 制 中 ， 只 有 一 个 组 成 员 从 目的 地 接收 消息 。 
正如 前 文 所 述 ， 这 两 个 局 动 器 也 可 以 包含 在 项 目 中 ， 有 具体 包含 哪 一 个 则 取决 于 绑 定 器 的 
类 型 ，spring-cloud-starter-stream-kafka 或 spring-cloud-starter-stream-rabbit。 

还 有 两 个 与 Spring Cloud Stream 相关 的 项 目 。 第 一 个 是 Spring Cloud Stream App 
Starters， 它 定义 了 一 组 Spring Cloud Stream 应 用 程序 ， 这 些 应 用 程序 都 可 以 独立 运行 或 
使 用 马上 要 介绍 的 第 二 个 项 目 Spring Cloud Data Flow。 在 这 些 应 用 程序 中 ， 开 发 人 员 可 
以 区 分 连接 嚣 、 网 络 协议 适配器 和 通用 协议 。Spring Cloud Data Flow 是 男 一 个 应 用 广泛 
且 叉 功能 强大 的 Spring Cloud 工具 包 。 它 通过 为 构建 数据 集成 和 实时 数据 处 理 管道 提供 
智能 解决 方案 ， 简 化 了 开发 和 部 署 。 基 于 微服 务 的 数据 管道 的 编排 是 通过 简单 的 DSL、 
拖 放 式 用 户 界 面 仪 表 板 和 了 REST API 联合 完成 的 。 


3.5 云 平 台 支 持 


Pivotal Cloud Foundry 《PCF) 是 一 个 用 于 部 署 和 管理 现代 应 用 程序 的 云 原 生平 台 。 
有 些 开 发 人 员 可 能 已 经 知道 ，Pivotal Software 公司 是 Spring framework 商标 的 所 有 者 。 大 
型 商业 平台 的 赞助 是 Spring 越 来 越 党 欢迎 的 重要 原因 之 一 。 显 而 易 见 的 是 ，PCEF 完全 文 
持 Spring Boot 的 可 执行 JAR 文件 , 以 及 所 有 Spring Cloud 微服 务 模式 (如 Config Server、 
服务 注册 表 和 断路 器 等 ) 。 这 些 类 型 的 工具 都 可 以 轻松 运行 和 配置 ， 并 且 可 以 使 用 各 种 
用 户 界 面 仪表 极 或 客户 端 命 令 行 。 PCF 的 开发 甚至 比 标 准 的 Spring Cloud 应 用 程序 更 简 
单 。 开 发 人 员 唯 一 要 做 的 就 是 将 正确 的 启动 器 包含 在 项 目 依赖 项 中 。 

JU sprine-cloud-services-starter-circuit-breaker 

UD sprine-cloud-services-starter-config-client 

JU sprine-cloud-services-starter-service-registry 


很 难 找到 一 个 没有 亚马逊 云 服 务 (Amazon Web Services，AWS) 支持 的 特 立 独行 的 
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云 架 构 。Spring Cloud 也 不 例外 。Spring Cloud for Amazon Web Services 提供 了 与 最 流行 
的 Web 工具 的 集成 ， 这 包括 用 于 与 简单 队列 服务 (Simple Queueing Service，SQS) 、 简 
单 通 知 服务 (Simple Notification Service, SNS)、ElasticCache 和 关系 数据 库 服务 (Relational 
Database Service，RDS) 进行 通信 的 模块 。 其 中 ，RDS 提供 了 诸如 Aurora、MySQL 或 
Oracle 之 类 的 引擎 。 可 以 使 用 CloudFormation 堆栈 中 定义 的 名 称 访问 远程 资源 。 众 所 周 
知 的 Spring 常规 和 模式 中 的 一 切 都 是 不 透明 的 ， 它 有 4 个 主要 模块 可 用 。 

口 。Spring Cloud AWS Core: 包括 使 用 spring-cloud-starter-aws 启动 右 ， 提 供 可 直接 

访问 EC2 实例 的 核心 组 件 。 

口 “Spring Cloud AWS Context: 提供 对 简单 存储 服务 (Simple Storage Service) 、 简 

单 电子 邮件 服务 (Simple E-mail Service ) 和 缓存 服务 的 访问 。 

口 “Spring Cloud AWS JDBC: 包括 使 用 starter spring-cloud-starter-aws-jdbe 司 动 磺 ， 

提供 数据 源 查找 和 配置 功能 ， 可 与 Spring 支持 的 任何 数据 访问 技术 一 起 使 用 。 

口 “Spring Cloud AWS Messaging: 包括 使 用 starter spring-cloud-starter-aws-messaging 

局 动 器 ， 人 允许 应 用 程序 使 用 SQS 点对点) 或 SNS (用 布 /订阅 ) 发 送 和 接收 
消息 。 

还 有 一 个 值得 一 提 的 项 目 ， 尽 管 它 仍 处 于 发 展 的 早期 阶段 ， 这 就 是 Spring Cloud 
Function， 它 可 以 为 无 服务 器 (Serverless) 架构 提供 文 持 。 这 里 所 谓 的 “无 服务 器 ”也 称 
为 功能 即 服务 (Function-as-a-Service，FaaS) ， 开 发 人 员 只 需要 创建 非常 小 的 模块 ， 这 些 
模块 部 署 在 完全 由 第 三 方 提 供 商 管理 的 容器 上 。 实 际 上 ，Spring Cloud Functions 为 AWS 
Lambda 和 Apache OpenWhisk〔( 最 受 欢迎 的 Faas 提供 商 ) 实现 了 适 配 程 序 。 我 们 将 持续 
关注 这 个 则 在 文 持 无 服务 器 方 法 的 项 目的 开发 。 

在 本 节 中 , 不 应 遗漏 的 还 包括 Spring Cloud Connectors 项 目 (以 前 称 为 Spring Cloud ) 。 
它 为 部 署 在 云 平 台 上 的 基于 JVM 的 应 用 程序 提供 了 抽象 层 。 实 际 上 ， 它 支持 Heroku 和 
Cloud Foundry， 在 该 项 目 中 ， 开 发 人 员 的 应 用 程序 可 以 使 用 Spring Cloud Heroku 
Connectors 和 Spring Cloud Foundry Connector 其 中 一 种 模块 连接 SMTP、RabbitMQ、Redis 
或 其 中 一 个 可 用 的 天 系数 据 库 。 


3.6 其 他 有 用 的 库 


围绕 微服 务 架 构 还 存在 一 些 重要 的 考量 ， 虽 然 这 些 方 面 不 能 被 视 为 其 核心 功能 ， 但 
也 非常 重要 。 第 一 个 要 考虑 的 就 是 安全 性 。 
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3.6.1 安全 性 


在 Spring Security 和 Spring Web 项 目 中 提供 了 使 用 OAuth2、JSON Web 令 有 站 (JSON 
Web Token，JWT) 或 基本 喘 份 验证 等 机 制 保护 API 安全 的 标准 实现 的 重要 部 分 。Spring 
Cloud Security 使 用 这 些 库 来 允许 开 友 人 员 轻 松 创建 实现 常见 模式 的 系统 ， 如 单 点 登录 

(Single Sign-on) 和 令 牌 中 继 ‘(Token Relay) 。 要 为 应 用 程序 启用 安全 管理 ， 应 该 包含 
spring-cloud-starter-security 启动 絮 。 


3.6.2 ”自动 化 测试 


关于 微服 务 开 发 的 下 一 个 要 考虑 的 重要 方面 是 自动 化 测试 。 对 于 微服 务 架 构 来 说 ， 
契约 测试 〈Contract Test) 的 重要 性 日 益 增 加 。ThoughtWeorks 公司 的 首席 科学 家 Martin 
Fowler 给 出 了 以 下 定义 : 


“集成 契约 测试 是 在 外 部 服务 边界 讲 行 的 测试 ， 它 将 用 于 验证 其 是 否 符合 消费 服务 
所 期 望 的 契约 。” 


Spring Cloud 对 于 单元 测试 方法 Spring Cloud Contract 有 一 个 非常 有 趣 的 现象 。 它 使 
用 WireMock 进行 流量 记录 ， 并 使 用 Maven 插件 生成 存根 。 

开发 人 员 也 有 机 会 使 用 Spring Cloud Task。 它 可 以 帮助 开发 人 员 使 用 Spring Cloud 创 
建 短 期 活跃 的 微服 务 ， 并 在 本 地 或 云 环境 中 运行 它们 。 要 在 项 目 中 局 用 它 ， 应 该 包含 
spring-cloud-starter-task 启动 器 。 


3.6.3 ”集群 功能 
最 后 要 考虑 的 一 个 重要 方面 《也 是 最 后 一 个 项 目 ) 是 Spring Cloud Cluster。 它 为 领导 


选举 和 常见 的 状态 模式 提供 了 解决 方案 ， 并 为 Zookeeper、Redis、Hazelcast 和 Consul 提 
供 了 抽象 和 实现 。 


3.7 项 目 概 述 


如 前 文 所 述 ，Spring Cloud 包含 许多 子 项 目 ， 可 提供 与 许多 不 同 工 具 和 解决 方案 的 集 
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成 。 这 很 容易 让 人 感到 茫然 〈 因 为 要 梳理 和 了 解 的 东西 太 多 ) ， 如 果 开 发 人 员 首次 使 用 
Spring Cloud 则 更 是 如 此 。 一 个 直观 的 图 表 可 能 胜 过 千言 万 语 ， 为 此 ， 图 3.1 以 分 门 别 类 
的 方式 呈现 了 Spring Cloud 最 重要 的 项 目 。 


“分 布 式 配 置 ”服务 发 现 服务 间 通 信 


| Spring Cloud | : 
Config < 
| Spring Cloud Spring Cloud 
| Zookeeper Config Zookeeper 


Consul Discovery 
Spring Cloud 


Consul Config | ”Spring Cloud F | > 
Consu| Discovery | Spring Cloud 


Spring Cloud 
Etcd Config | ee 


Spring Cloud 
SecUrity 


Spring Cloud 
Stream 


Spring Cloud Spring Cloud 
Cloud Foundry Bus 


L 


Spring Cloud spring Cloud 
AWS Stream Apps 


Spring Cloud Spring Cloud 
Function bles lee 


Spring Cloud 
Connectors 


图 3.1 Spring Cloud 项 目 分 类 


Spring Cloud 
, Sleuth Stream 


3.8 版 本 列车 


正如 图 3.1 所 示 ，Spring Cloud 中 有 许多 项 目 ， 它 们 之 间 有 很 多 关系 。 根 据 定 义 ， 这 
些 都 是 具有 不 同 版 本 层 登 和 版 本 号 的 独立 项 目 。 在 这 种 情况 下 ， 开 发 人 员 的 应 用 程序 中 
的 依赖 关系 管理 可 能 会 出 现 问 题 ， 并 且 需 要 提供 关于 所 有 项 目 版 本 之 间 关 系 的 知识 。 为 
了 简化 操作 ，Spring Cloud 引入 了 局 动 器 机 制 〈 前 文 已 经 介绍 过 ) 和 版 本 列车 (Release 
Train) 。 版 本 列车 将 通过 名 称 而 不 是 版 本 来 识别 ， 以 避免 与 子 项 目 产 生 混 清 。 

有 趣 的 是 ， 版 本 列车 以 伦敦 地 铁 站 命名 ， 按 字母 顺序 排列 。 第 一 个 版 本 是 Angel， 第 
二 个 版 本 是 Brixton， 依 此 类 推 。 

依赖 项 管理 的 整个 机 制 基于 物料 清单 (Bill of Materials，BOM) ， 这 是 用 于 管理 独 
立 版 本 工件 的 标准 Maven 概念 。 以 下 是 一 个 实际 表格 ， 其 中 包含 的 Spring Cloud 项 目 版 


.人 
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本 已 经 被 分 配给 版 本 列车 。 有 些 名 称 带 有 后 缀 M[XI]， 其 中 的 [如 是 版 本 号 ，M[ 和 I 则 表示 
里 程 碑 (Milestone )， 说 明 它 是 稳定 可 靠 的 重要 版 本 。SR[ 天 表示 服务 版 本 (Service 
Release) ， 意 指 该 版 本 修复 了 一 些 关 键 错误 。 正 如 表 3.1 所 示 ，Spring Cloud Stream 拥有 
自己 的 版 本 列车 ， 它 使 用 与 Spring Cloud 项 目 相 同 的 规则 对 其 子 项 目 进行 分 组 。 


组 ” 件 
spring-cloud-aws 
spring-cloud-bus 
spring-cloud-cli 
spring-cloud-commons 
spring-cloud-contract 
spring-cloud-config 
spring-cloud-netflrx 
spring-cloud-securt 
spring-cloud-cloudfound 
spring-cloud-consul 


sprine-cloud-sleuth 


表 3.1 Spring Cloud 版 本 列车 


Camden.SR7 | Dalston.SR4 Edgware.M1 | Finchlev.M2 |Finchley.BUILD-SsNAPSHOT 


114RELEASE |121RELEASE |121RELEASE |200M! |200BUID-SNAPSHOT 
122RELEASE |131RELEASE |131RELEASE |200M! |200BUILD-SNAPSHOT 
124RELEAsE |134RELEASE |140MI |200M! |200BUID-SNAPSHOT 
19RELEASE |124REIEASE |130MI |200M2? |200BUID'SNAPSHOT 
OSRELEASE |LL4RELEASE |120MI |200M? |200BUID'SNAPSHOT 
123RELEASE |133RELEASE |140MI |200M? |200BUID-SNAPSHOT 
127RELEASE |135RELEASE |140MI |200M? |200BUID'SNAPSHOT 
11.4RELEASE |121RELEASE |121RELEASE |200M! |200BUILD-SNAPSHOT 
10.1RELEASE |110RELEASE |110RELEASE |200M! |200BUILD-SNAPSHOT 
11.4RELEASE |121RELEASE |121RELEASE |200M! |200BUID-SNAPSHOT 
113RELEASE |125RELEASE |130MI |200M? |200BUID:SNAPSHOT 


Elmhurst BUILD-SNAPSHOT 
1.1.2.RELEASE 2.0.0.BUILD-SNAPSHOT 
14ASRELEASE |1.54RELEASE |15.6RELEASE |200M3 |200M3 

1.03RELEASE |1.12RELEASE |120RELEASE |200M! |200RELEASE 


现在 ， 开 及 人 员 需 要 做 的 就 是 在 Maven 的 pom.xml 的 依赖 关系 管理 部 分 提供 正确 的 
版 本 列车 名 称 ， 然 后 使 用 局 动 右 包含 项 目 。 


<dependencyManagement> 


sprine-cloud-stream 


sprine-cloud-zookeeper 
spring-boot 


sprine-cloud-task 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactIid>spring-cloud-dependencies</artifactId> 
<Vversion>Finchley.M2</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 
<dependenclies> 
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<dependency> 
<JroupId>org .springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-config</artifactId> 
</dependency> 


</dependencies> 


以 下 是 Gradle 的 相同 示例 。 


dependencyManagement 1 
imports 1 
mavenBom “ :spring—cloud-dependencijes:Finchley.M2" 
} 
} 
dependencies 1 
compile ":spring—cloud-starter—config' 


3.9 小 结 


本 章 介 绍 了 Spring Cloud 中 最 重要 的 项 目 ,它们 都 是 Spring Cloud 的 组 成 部 分 。 此 外 ， 
本 章 还 对 每 个 项 目 进 行 了 明确 的 分 类 ， 阅 读 完 本 章 之 后 ， 相 信 开 有 人 员 应 该 能 够 清晰 地 
知道 应 用 程序 中 必须 包含 哪个 库 才 能 实现 服务 发 现 、 分 布 式 配置 、 断 路 器 或 负载 均衡 器 
等 模式 。 开 发 人 员 还 应 该 认识 到 应 用 程序 上 下 文 和 Bootstrap 上 下 文 之 间 的 差异 ， 并 了 解 
如 何 使 用 基于 “版 本 列车 ”概念 的 依赖 关系 管理 在 项 目 中 包含 依赖 项 。 本 章 需要 引起 开 
发 人 员 注 意 的 最 后 一 件 事 是 与 Spring Cloud 集成 的 一 些 工 具 ， 如 Consul、Zookeeper、 
RabbitMQ 或 Zipkin。 本 章 对 这 些 工具 做 出 了 不 同 程度 的 介绍 ， 并 指出 了 负责 与 这 些 工 具 
交互 的 项 目 。 

本 章 完 成 了 本 书 的 第 一 部 分 。 在 这 一 部 分 中 ， 主 要 目标 是 让 开发 人 员 了 解 与 Spring 
Cloud 项 目 相 关 的 基础 知识 。 阅 读 完 本 部 分 之 后 ,开发 人 员 应 该 能 够 识别 基于 微服 务 的 架 
构 中 最 重要 的 元 素 ， 能 有 效 地 使 用 Spring Boot 来 创建 简单 和 更 高 级 的 微服 务 ， 最 后 ， 开 
发 人 员 还 应 该 能 够 列 出 所 有 最 受 欢 迎 的 子 项 目 ， 它 们 也 是 Spring Cloud 的 组 成 部 分 。 

现在 ， 开 发 人 员 可 以 继续 阅读 本 书 的 下 一 部 分 ， 详 细 了 解 那些 负责 在 Spring Cloud 
中 实现 分 布 式 系统 的 常见 模式 的 子 项 目 。 其 中 大 多 数 都 基于 Netflix OSS 库 。 后 续 内 容 将 
从 提供 服务 注册 表 、Eureka 发 现 服务 器 的 解决 方案 开始 。 


一 一 一 一 一 


微服 务 架构 常见 元 素 和 
洪 构 第 见 元 又 和 Spring Cloud 实现 
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在 本 章 之 前 已 经 多 次 讨论 过 服务 发 现 。 实 际 上 ， 它 是 微服 务 架 构 中 最 受 欢 迎 的 技术 
方面 之 一 mit OSS 实现 中 不 能 省 略 这 样 的 主题 ， 他 们 并 没有 决定 使 用 具有 类 似 功能 
的 任何 现 有 工具 ， 而 是 专门 为 目 己 的 需求 设计 和 开发 了 一 个 发 现 服务 器 。 然 后 ， 它 已 毕 
与 其 他 几 个 工具 一 起 开源 。Netflix OSS 发 现 服务 器 被 称 为 Eureka。 

用 于 与 Eureka 集成 的 Spring Cloud 库 由 两 部 分 组 成 ， 即 客户 端 和 服务 器 问 。 服 务 器 
将 作为 单独 的 Spring Boot 应 用 程序 启动 ， 并 公开 一 个 API， 该 API 将 允许 收集 已 注册 服 
务 的 列表 ， 以 及 添加 带 有 位 置地 址 的 新 服务 。 可 以 配置 和 部 署 服 务 器 以 使 其 具有 高 可 用 
性 ， 每 个 服务 髓 都 将 其 状态 复制 到 其 他 服务 器 。 客 户 端 作为 依赖 项 包含 在 微服 务 应 用 程 
序 中 ， 它 负责 启动 后 的 注册 、 关 闭 前 的 注销 ， 以 及 通过 轮 询 Eureka Server 使 注册 列表 保 
持 最 新 。 

本 章 将 要 讨论 的 主题 包括 : 

口 ”开发 运行 艇 入 式 Eureka Server 的 应 用 程序 。 

从 客户 端 应 用 程序 连接 到 Eureka Server。 
高 级 发 现 客户 端 配置 。 

在 客户 疹 和 服务 器 之 间 局 用 安全 通信 。 
配置 故障 转移 和 对 等 复制 机 制 | 。 

在 不 同 区 域 中 注册 客户 端 应 用 程序 的 实例 。 


OO LDL DO 


4.1 在 服务 器 端 运行 Eureka 


在 Spring Boot 应 用 程序 中 运行 Eureka Server 并 不 是 一 项 很 难 的 任务 。 现 在 不 妨 来 看 
一 看 如 何 做 到 这 一 点 。 
(1) 首先 ， 必 须 将 正确 的 依赖 项 包含 在 开发 人 员 的 项 目 中 。 显 然 ， 这 里 需要 使 用 相 
应 的 局 动 右 。 
<dependency> 
<grouplId>org.springframework.cloud</groupId> 


<artifactId>spring—-cloud-starter-eureka—server</artifactId> 
</dependency> 
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(2) 还 应 在 主 应 用 程序 类 上 启用 Eureka Server。 


QSpringBootApplication 
QEnableEurekaServer 
public class DiscoveryApplication 1 


public static void main(string[|] args) 1 
new 

SpringApplicationBuilder (DiscoveryApplication.class) .web (true) .runl 

args)});} 

} 
} 
(3) 有 趣 的 是 ， 客 户 端 的 依赖 项 将 与 服务 器 的 局 动 器 一 起 被 包含 ， 它 们 对 开 有 人 员 
是 很 有 用 的 ， 但 仅 限 于 在 高 可 用 性 模式 下 局 动 Eureka 并 在 发 现实 例 之 间 进 行 对 等 
(Peer-to-Peer) 通信 。 在 运行 独立 实例 时 ， 除 了 在 局 动 期 间 在 日 志 中 打印 一 些 错误 之 外 ， 
它 实际 上 并 没有 其 他 用 处 。 开 发 人 员 可 以 从 初始 依赖 项 中 排除 spring-cloud-netflix-eureka- 
client， 也 可 以 考虑 使 用 配置 属性 茶 用 友 现 客户 端 。 建 议 开 有 友人 员 优先 选择 第 二 种 方式 ， 
并 且 在 这 种 情况 下 ， 可 以 将 默认 服务 器 端口 更 改 为 8080 以 外 的 其 他 内 容 。 以 下 就 是 
application.yml 文件 的 代码 片段 。 
号 区 下 天 外 下 二 
port: Ss{PORT:8761) 
eureka: 
Client: 
registerWithEureka: false 
fetchRegistry: false 
(4) 在 完成 上 述 步骤 之 后 ， 开 发 人 员 即 可 局 动 第 一 个 Spring Cloud 应 用 程序 。 可 以 
从 集成 开发 环境 运行 main 类 或 使 用 Maven 构建 项 目 。 使 用 java -jar 命令 运行 它 并 等 待 出 
现 日 志 行 Started Eureka Server。 启 动 完成 之 后 ， 会 出 现 一 个 简单 的 用 户 界 面 仪 表 板 ， 它 
可 以 用 作 主 页 ， 地 址 是 http://localhost:8761， 并 且 可 以 使 用 /eureka/* 路 征调 用 HTTP API 
方法 。Eureka 仪表 板 不 会 提供 太 多 功能 ， 事 实 上 ， 它 主要 用 于 检查 注册 服务 列表 。 这 可 
以 通过 调用 REST API http://localhost:8761/eureka/apps 端点 来 找到 。 

总 而 言 之 ， 开发 人 员 已 经 知道 如 何 使 用 Spring Boot 运行 Eureka 独立 服务 器 ， 以 及 如 
何 使 用 用 户 界 面 控制 台 和 HTTP 方法 检查 已 注册 微服 务 的 列表 。 但 是 ， 目 前 开 友 人 员 仍 
然 没 有 能 够 在 发 现 中 注册 自己 的 任何 服务 ， 现 在 是 时 候 改 变 它 了 。 上 有 具有 发 现 服务 器 和 客 
户 端 实现 的 示例 应 用 程序 可 以 在 master 分 支 中 的 GitHub (https://github.com/piomin/ 
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sample-spring-cloud-netflix.git) 上 获得 。 
4.2 在 客户 端 启 用 Eureka 


与 服务 占 端 一 样 ， 只 需要 包含 一 个 依赖 项 即 可 为 应 用 程序 局 用 Eureka Client。 因 此 ， 
首先 要 在 项 目的 依赖 项 中 包含 以 下 局 动 右 。 
<dependency> 
<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-—cloud-starter-—eureka</artifactId> 
</dependency> 
该 示例 应 用 程序 只 是 与 Eureka Server 进行 通信 。 它 必须 注册 目 己 并 发 送 元 数据 
(Metadata) 信息 ， 如 主机 、 端 口 、 运 行 状况 指示 器 URL 和 主页 等 。Eureka 将 从 属于 服 
务 的 每 个 实例 接收 心跳 〈Heartbeat) 消息 。 如 果 在 已 配置 的 一 段 时 间 后 未 收 到 心跳 消息 ， 
则 会 从 注册 表 中 删除 该 实例 。 友 现 客户 端的 第 二 个 职责 是 从 服务 占 获 取 数 据 ， 然 后 绥 存 
它 并 定期 请 求 更 新 。 可 以 通过 使 用 @EnableDiscoveryClient 注解 main 类 来 启用 它 。 令 人 
惊讶 的 是 ， 还 有 男 一 种 方法 可 以 激活 此 功能 。 开 发 人 员 可 以 使 用 @EnableEurekaClient 注 
解 ， 尤 其 是 如 果 在 类 路 径 中 有 多 个 发 现 客户 端 实现 (如 Consul、Eureka、ZooKeeper) 时 
更 是 如 此 。 前 面 提 到 的 @EnableDiscoveryClient 注解 存在 于 spring-cloud-commons 中 ， 而 
(@EnableEurekaClient 注解 则 存在 于 spring-cloud-netflix 中 , 并 且 仅 适用 于 Eureka。 以 下 是 
发 现 客 户 端 应 用 程序 的 main 类 。 
aspringBootapp1ication 
QEnableDiscoveryClient 
public class ClientApplication { 


public static void main(Sstringl[l|] args) 1 
new 
SpringApplicationBRBuilder (ClientApplication.class} .web (true) .run(args}); 


) 
) 
不 必 在 客户 端的 配置 中 提供 发 现 服务 器 地 址 ， 因 为 它 在 默认 主机 和 端口 上 可 用 。 但 
是 , 开发 人 员 可 以 很 容易 地 想象 Eureka 没有 侦 听 其 默认 的 8761 端口 。 配置 文件 的 片段 如 
下 所 示 。 可 以 使 用 EUREKA_URL 参数 逢 兰 发 现 服务 器 的 网 络 地 址 ， 客 尸 端的 侦 听 端口 也 可 
以 使 用 PORT 属性 覆 兰 。 应 用 程序 在 发 现 服务 器 中 注册 的 名 称 将 取 目 spring.application name 
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属性 。 


Spring: 
application: 
name: client-service 


Server: 
port: S${PORT:8081) 


eureka: 
client: 
SeIrVviceUrl: 
defaultzone: S${EUREKA URL:http://localhost:8161/eureka/} 


现在 可 以 在 localhost 上 运行 示例 客户 请 应 用 程序 的 两 个 独立 实例 。 要 实现 这 一 点 ， 
应 该 在 局 动 时 为 实例 覆盖 侦 昕 端口 的 数量 ， 如 下 所 示 。 

JjJava -jar -DPORT=8081 target/sample-client-service-l1.0-SNAPSHOT .JjJar 

Java -JjJar -DPORT=8082 target/sample-client-service-1.0-SNAPSHOT .JjJar 

如 图 4.1 所 示 ， 有 两 个 client-service 〈 客 户 站 服务 ) 实例 注册 了 主机 名 为 piomin， 冰 
口 则 分 别 为 8081 和 8082 。 


Instances currently registered with Eureka 


Application 和 Arwvallabllity Fomes 


CLIENT-SERVICE 


General Infe 


NuUrmm- ot-cpars 

CaTrent-merors-Usage G3mb (21%} 

Sefer [四 

regie turd rerdicas he: imacalheycd ?Eleureky 
urallabla=-mplicas here: Marcalhoud ?laureka, 


dvailable-regplicas 


Instance Info 


图 4.1 使 用 Eureka 注册 的 两 个 实例 
4.2.1 关机 时 取消 注册 


检查 撤销 注册 如 何 与 Eureka 客户 端 一 起 工作 是 一 项 艰巨 的 任务 。 开 发 人 员 的 应 用 程 
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序 应 该 正常 关闭 ， 以 便 能 够 拦截 已 停止 的 事件 (Event) 并 将 事件 发 送 到 服务 器 。 正 第 3 
闭 的 最 佳 方法 是 使 用 Spring Actuator 的 /shutdown 靖 点 。 该 执行 器 是 Spring Boot 的 一 部 分 ， 
它 可 以 通过 在 pom.xml 中 声明 spring-boot-starter-actuator 依赖 项 来 包含 在 项 目 中 。 默认 情 
况 下 它 是 被 禁用 的 ， 因 此 必须 在 配置 属性 中 启用 它 。 为 简单 起 见 ， 可 以 禁用 该 端点 的 用 
户 / 密 码 安 全 性 。 
endpoints: 
Shutadown : 
enabled: true 
sensitive: false 
要 关闭 应 用 程序 ， 必 须 调用 POST /shutdown API 方法 。 如 果 收 到 回复 {f"message": 
"Shutting down,bye .."}， 则 表示 一 切 顺利 ， 进 程 已 经 启动 。 在 禁用 应 用 程序 之 前 ， 将 打 
印 出 从 Shutting down DiscoveryClient ...〈 正 在 关闭 DiscoveryClient》 行 开始 的 一 些 日 志 。 
之 后 ， 该 服务 将 从 发 现 服务 器 取消 注册 ， 并 从 注册 服务 列表 中 完全 消失 。 可 以 通过 调用 
http://localhost:8082/shutdown 来 天 闭 客户 端 实例 扔 (可 以 使 用 任何 REST 客户 端 来 调用 它 ， 
如 Postman) ， 因 此 ， 现 在 只 有 在 端口 8081 上 运行 的 实例 仍然 可 以 在 仪表 板 中 看 到 ， 如 
图 4.2 所 示 。 


Instances currently registered with Eureka 


Application MPs Awailability Zones Status 


CLIENT-SERVICE n/a (dj (1 UP {1)- piomin:client-service:8081 


图 4.2 现在 只 有 一 个 实例 


Eureka Server 仪表 板 还 提供 了 一 种 方便 的 方法 来 检查 新 创建 和 已 取消 租约 〈Lease ) 
的 历史 记录 ， 如 图 4.3 所 示 。 


[EE Last 1000 newly registered leases 
TImestamp Lease 


Nov 1 2017 11:36:11 PM CLIENT-SERVICE(piomin:client-service:8082) 


Nov 1, 2017 11:36:11 PM CLIENT-$SERVICE(piomin:client-service:8082) 


图 43 和 碍 看 已 取消 租约 的 历史 记录 


虽然 像 这 样 从 容 地 关闭 显然 是 最 适合 停止 应 用 程序 的 方法 ， 但 在 现实 世界 中 ， 开 发 
人 员 并 不 总 是 能 够 实现 它 。 可 能 会 发 生 许多 意外 情况 ， 如 服务 器 计算 机 重新 启动 、 应 用 
程序 故障 或 客户 端 与 服务 器 之 间 的 接口 处 的 网 络 问题 。 从 发 现 服务 器 的 角度 来 看 ， 从 集 
成 开发 环境 停止 客户 端 应 用 程序 或 从 命令 行 终止 进程 ， 其 情形 没什么 不 同 。 如 果 开发 人 
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员 和 尝试 这 样 做 , 则 将 看 到 不 会 触发 发 现 客户 端的 天 闭 进程 , 并 且 在 具有 UP 状态 的 Eureka 
仪表 板 中 仍然 可 以 看 到 该 服务 。 此 外 ， 该 租约 将 永 不 过 期 。 

为 了 避免 这 种 情况 ， 应 该 更 改 服 务 器 端的 默认 配置 。 为 什么 这 样 的 问题 会 出 现在 默 
认 设 置 中 呢 ? 实际 上 ， 这 是 因为 Eureka 提供 了 一 种 特殊 机 制 ， 当 注册 表 检 测 到 一 定数 量 
的 服务 没有 及 时 续 订 它们 的 租约 时 ， 注 册 表 将 停止 过 期 条 目 。 这 应 该 可 以 防止 注册 表 在 
发 生 网 络 故障 时 清除 所 有 和 条目。 该 机 制 称 为 自我 保护 模式 (Self-Preservation Mode) ， 开 
发 人 员 可 以 使 用 application.yml 中 的 enableSelfPreservation 属性 禁用 它 。 当 然 ， 在 实际 生 
产 模式 中 它 不 应 该 被 禁用 。 

eureka: 


SeTVeT : 
enableSelfPreservation: false 


4.2.2 ”以 编程 方式 使 用 发 现 客户 问 


客户 端 应 用 程序 局 动 后 ， 将 自动 从 Eureka Server 获取 已 注册 服务 的 列表 。 但 是 ， 这 
可 能 需要 以 编程 方式 使 用 Eureka 的 客户 端 API。 开 发 人 员 有 以 下 两 种 可 能 的 选择 。 
口 “comnetflix.discovery.EurekaClient: 它 实现 了 Eureka Server 公开 的 所 有 HTTP API 
方法 ， 有 关 这 些 方法 的 详细 说 明 ， 请 参见 第 4.5 节 “Eureka API”。 
DD org.springframework.cloud.client.discovery.DiscoveryClient: 它 是 原生 Netflix 
EurekaClient 的 Spring Cloud 苦 代 上 品 。 它 提供 了 一 个 对 所 有 发 现 客户 端 都 有 用 的 
简单 通用 的 API。 它 有 两 种 方法 : getServices 和 getInstances。 


private static final Logger LOGGER = 
LoggerFactory.getLogger (ClientcController.class}): 


QAutowired 
private DiscoveryClient discoveryClient.; 


QGetMapping ("/ping") 
Public List<Servicelnstance> ping() I 

List<ServicelInstance> instances = 

discoveryClient .getinstances!( CLIENT—SERVICE™),; 
LOGGER . Infto (INSTANCES : count={}", instances.sijze{()); 
instances.stream() .forEach (it -> LOGGER.info("INSTANCE: id={}, 
port={}", it.getSserviceld(}, it.getPort(}))})); 

return instances; 


} 
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这 里 有 一 个 与 前 面 的 实现 有 关 的 很 有 趣 的 事情 。 如 果 在 服务 局 动 后 立即 调用 /ping 端 
点 ， 则 不 会 显示 任何 实例 。 这 与 啊 应 缓存 机 制 有 关 ， 在 第 4.3.4 节 中 将 对 此 有 详细 介绍 。 


4.3 高 级 配置 设置 


Eureka 的 配置 设置 可 分 为 以 下 3 个 部 分 。 
口 ”服务 器 (Server) : 它 将 自 定义 服务 器 行为 。 它 包含 前 级 为 eureka.server.* 的 所 
有 属性 。 完 整 的 可 用 字段 列表 可 以 在 EurekaServerConfigBean 类 中 找到 
( https://github.com/spring-cloud/spring-cloud-netflix/blob/master/spring-cloud- 
netf{lix-eureka-server/src/main/Java/org/sprineframework/cloud/netflix/eureka/server/ 
EurekaServerConfieBean.java) 。 
口 “客户 站 (Client) : 这 是 Eureka 客户 端的 两 个 可 用 属性 部 分 中 的 第 一 个 。 它 负责 
配置 客户 靖 如 何 查 询 注 册 表 以 得 找 其 他 服务 。 它 包含 前 组 为 eureka.client.* 的 所 
有 属性 。 有 关 可 用 字段 的 完整 列表 ， 可 以 参考 EurekaClientConfigBean 类 
( https://github.com/springe-cloud/sprine-cloud-netflix/blob/master/spring-cloud- 
netflix-eureka-client/src/main/Java/org/springframework/cloud/netflix/eureka/ 
EurekaClientConfieBean.java) 。 
口 et (Instance〉: 它 将 自 定义 Eureka 客户 端 行为 的 当前 实例 ， 如 端口 或 名 称 。 
包含 前 级 为 eureka.instance.* 的 所 有 属性 。 有 关 可 用 字段 的 完整 列表 ， 可 以 参 
和 EurekalInstanceConfigBean 类 (https://github.conyspring-cloud/spring-cloud-netflix/ 
blob/master/sprine-cloud-netflix-eureka-client/src/main/Java/org/sprineftramework/ 
cloud/netflix/eureka/EurekalnstanceConfigBean.lava) 。 
前 文 已 经 介绍 了 如 何 使 用 其 中 一 些 属性 以 获得 所 需 的 效果 。 本 节 后 续 内 容 将 讨论 与 
配置 设置 自 定 义 相 关 的 一 些 有 趣 场景 。 这 里 不 需要 解释 所 有 属性 ， 开 发 人 员 可 以 在 之 前 
列 出 的 所 有 类 的 源 代码 所 包含 的 注释 中 阅读 到 对 它们 的 说 明 。 


4.3.1 刷新 注册 表 


现在 可 以 回 到 上 一 个 示例 。 虽 然 目 我 保护 模式 已 被 禁用 ， 但 服务 器 等 符 租 约 取消 仍 需 : 
很 长 时 间 。 这 有 几 个 原因 ， 第 一 个 原因 是 每 个 客户 端 服务 每 30 秒 〈 默 认 值 ) 回 服务 髓 发送 
一 次 心 踢 ， 该 间隔 值 可 使 用 eureka.instance.leaseRenewalIntervalInSeconds 属性 进行 配置 。 如 
果 服 务 器 没有 收 到 心跳 ， 那 么 它 会 在 从 注册 表 中 删除 实例 之 前 等 待 90 秒 ， 然 后 才 切 断 发 送 
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到 该 实例 的 流量 ， 这 个 等 待 的 秒 数值 可 以 使 用 eureka.instance.leaseExpirationDurationInSeconds 
属性 进行 配置 。 这 两 个 参数 均 在 客户 端 设 置 。 出 于 测试 目的 ， 我 们 定义 一 个 很 小 的 以 秒 
为 单位 的 值 。 
eureka: 
instance: 


leaseRenewallntervallInSeconds: 1 
leaseExpirationDurationlInSeconds: 2 


还 有 一 个 应 该 在 服务 器 端 进行 更 改 的 属性 。Eureka 在 后 台 运 行 驱逐 任务 ， 负 责 检查 
是 否 仍 在 接收 来 自 客户 端的 心跳 。 默认 情况 下 ， 它 每 60 秒 触发 一 次 。 因 此 ， 即 使 租约 续 
订 的 间隔 和 租约 到 期 的 持续 时 间 被 设置 为 相对 较 低 的 值 ， 也 仍然 需要 60 秒 (在 最 坏 情况 
下 ) 才能 删除 服务 实例 。 可 以 使 用 evictionIntervalTimerInMs 属性 配置 后 续 计 时 器 在 台 秒 
之 间 的 延迟 。 请 注意 ， 该 属性 与 前 面 所 讨论 的 属性 设置 不 同 ， 它 是 以 毫秒 为 单位 的 。 


eureka: 


SeEIVer: 
enableSelfPreservation: false 
evictionIntervalTimerInMs: 3000 


所 有 必需 参数 都 已 在 客户 端 和 服务 器 端 定 义 完毕 。 现 在 ， 开 发 人 员 可 以 再 次 运行 发 
现 服务 器 ， 然 后 使 用 -DPORT VM 参数 在 端口 8081、8082 和 8083 上 运行 客户 端 应 用 程序 
的 3 个 实例 。 之 后 ， 再 逐个 关闭 端口 8081 和 8082 上 的 实例 ， 只 需 删除 它们 的 进程 即 可 。 
结果 怎么 样 ? 被 禁用 的 实例 几乎 立即 就 会 从 Eureka 注册 表 中 删除 。 

如 图 4.4 所 示 就 是 来 自 Eureka Server 的 日 志 片 段 。 


2017-11-02 21:44:56.533 INFO 40056 --- [a-EvictionTimer] &.n.e,.registry.AbstractInstanceRegistry : Evicting | items (expired=|1, evictionLimit=1) 

2 7 -D2 21:44:50.35343 WARN 40056 -= [a-EvictionTimer] ce.n.e.registry.AbstractInstanceR emstry : Ds: Registry: expired lease for CLIENT-SERVICE/piomin:client- 
Service:8082 

2017-11-02 21:44:56.538 INFO 40056 —- [a-EvictionTimer] cn.e.registry.AbstractInstanceRegistry : Cancelled instance CLIENT-SER YICE/piomin:client-service:S082 
(replication=talse) 

2017-11-02 21:44:59.533 INFO 40056 --- [a-EvictionTimer| cn.e,.registry.AbstractlnstanceRepistry ; Running the evict task with compensation Tlme Oms 


201711-02 21:4459.533 INFO 40056 -—- [a-EvictionTimer] en.e.remistry.AbstractInstanceRegistry : Evicting | items (expired=|, evictionLimit=1) 

2017-11-02 21:44:59.533 WARN 40056 --- [a-EvictionTimer| c.n.e.registry.AbstractlnstanceRegistry : DS: Registry: expired lease for CLIENT-SERYICE/piomin:chient- 
service:8081 

2017-11-02 21:44:59.534 INFO 40056 —- [a-ExwictionTimer] e.n.e registry.AbstractInstanceReegistry : Cancelled instance CLIENT-SER YICE/piomin:client-service:aD8] 


(replication=false) 


44 Eureka Server 的 日 志 片 段 


在 端口 8083 上 仍 有 一 个 可 用 的 实例 正在 运行 。 与 自动 保护 模式 相关 的 相应 警告 将 打 
印 在 用 户 界面 仪表 板 上 。 一 些 额 外 的 信息 (如 租约 到 期 状态 或 最 后 一 分 钟 期 间 的 续 订 数 
量 ) 也 可 能 很 有 趣 。 通 过 操纵 所 有 这 些 属性 ， 开 发 人 员 可 以 自 定义 过 期 租约 删除 进程 的 
维护 。 但 是 ， 确 保 已 定义 的 设置 不 会 缺乏 系统 性 能 非常 重要 。 还 有 一 些 其 他 元 素 对 配置 
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的 变化 很 敏感 ， 如 负载 均衡 器 、 网 关 和 断路 占 和 等。 如果 蔡 用 目 我 保护 模式 ，Eureka 会 打 
印 一 条 警告 消息 ， 如 图 4.5 所 示 。 


Lease expirationm enabled tue 


Reonews threshold 记 


Honews (last min) ad 


THE SELF PRESERVATION MODE |S TURNED OFFTHIS MAY NOT PROTECT INSTANCE EXPIRY IN CASE OF NETWORK/OTHER PROBLEMS. 
DS Replicas 


Instances currently registered with Eureka 


Application Availalility Fones “tatus, 


CUIENT-SERVICE | UP 1 


4.5 ”禁用 日 我 保护 模式 之 后 显示 的 警告 消 居 
4.3.2 更改 实例 标 况 符 


在 Eureka 上 注册 的 实例 将 按 名 称 分 组 ， 但 每 个 实例 都 必须 发 送 一 个 唯一 的 ID， 服 务 
器 才能 识别 它 。 也 许 你 已 经 注意 到 , instanceld 将 显示 在 仪表 板 的 每 个 服务 组 的 Status ( 状 
态 ) 列 中 。Spring Cloud Eureka 会 自动 生成 该 数字 ， 它 等 于 以 下 字段 的 组 合 。 

$s${spring.cloud.client.hostname} :${spring.application.name}:${spring. 

application.instance id:${server.port}}}. 


可 以 使 用 eureka.instance.instanceld 属性 轻松 履 兹 此 标识 符 。 出 于 测试 目的 ， 开 发 人 
员 可 以 使 用 以 下 配置 设置 和 -DSEQUENCE NO = [n] VM 参数 局 动 客 户 端 应 用 程序 的 一 
些 实例 。 其 中 ，[n] 是 从 1 开始 的 顺序 编号 。 以 下 是 一 个 客户 端 应 用 程序 的 配置 示例 ， 访 
客户 端 应 用 程序 将 基于 SEQUENCE NO 参数 动态 设置 侦 听 端口 和 发 现 instanceld。 
导 权 于 环 司 和 
port: 808${SEQUENCE NO] 


euUreka: 
lilinstance: 


instanceId: ${spring.application.name}—${SEQUENCE NO}] 
可 以 在 Eureka 仪表 板 中 查看 其 结果 ， 如 图 4.6 所 示 。 


Instances currently registered with Eureka 


Application Ahlls Availability Zones 


CLIENT-SERVICE n/a (3) (3) 


图 4.6 动态 设置 的 实例 标识 符 


4.3.3 ”选择 使 用 IP 地 址 


默认 情况 下 ， 所 有 实例 都 在 其 主机 名 下 注册 。 假 设 开 发 人 员 在 网 络 上 启用 了 域名 系 
统 (Domain Name System，DNS) ， 这 是 一 种 非常 方便 的 方法 。 但 是 ， 对 于 用 作 企 业 中 
的 微服 务 环境 的 一 组 服务 器 来 说 ，DNS 并 不 常见 。 笔 者 束 是 这 种 情况 。 除 了 将 主机 名 及 
其 IP 地 址 添加 到 所 有 Linux 机 器 上 的 /etc/hosts 文件 之 外 ， 没 有 其 他 办 法 。 此 解决 方案 的 
蔡 代 方法 是 更 改 注册 过 程 配 置 设置 以 通告 服务 的 他 地 址 而 不 是 主机 名 。 要 实现 此 目的 ， 
应 在 客户 靖 将 eureka.instance.preferIpAddress 属性 设置 为 tue。 执 行 该 项 设置 之 后 ， 虽 然 
注册 表 中 的 每 个 服务 实例 在 Eureka 仪表 板 中 仍 将 显示 包含 主机 名 的 instanceld, 但 如 果 单 
击 此 链接 , 则 将 根据 卫 地 址 执行 重 定 癌 。 负 责 通 过 HTTP 调用 其 他 服务 的 Ribbon 客户 端 
也 遵循 相同 的 原则 。 

如 果 开 发 人 员 决 定 使 用 IP 地 址 作为 确定 服务 的 网 络 位 置 的 主要 方法 ， 则 可 能 会 过 到 
问题 。 简 而 言 之 ， 如 果 开 发 人 员 为 目 己 的 计算 机 分 配 了 多 个 网 络 接口 ， 则 可 能 会 出 现 此 
问题 。 例 如 ， 在 笔者 工作 过 的 一 个 企业 中 ， 其 管理 模式 (从 个 人 工作 站 到 服务 器 的 连接 》 
和 生产 模式 (两 台 服 务 右 之 间 的 连接 ) 具有 不 同 的 网 络 。 因 此 ， 每 台 服 务 嚣 都 有 两 个 分 
配 有 不 同 卫 前 级 的 网 络 接口 。 要 选择 正确 的 接口 ， 可 以 在 application.yml 配置 文件 中 定 
义 被 忽略 的 模式 列表 。 例 如 ， 假 设 要 忽略 名 称 以 ethl 开头 的 所 有 接口 ， 则 可 以 进行 以 下 

SpI1ing: 

cloud: 
1netutils: 
igqnoredIinterfaces: 


过 
还 有 另 一 种 方法 也 可 以 达到 这 种 效果 。 开 发 人 员 可 以 定义 应 该 首选 的 网 络 地 址 : 
Spring: 
cloud: 


inetutils: 
preferredNetworks: 
- 192.168 


4.3.4 ”响应 缓存 


Eureka Server 默认 会 缓存 啊 应 。 绥 存 每 30 秒 失效 一 次 。 可 以 通过 调用 HITP API 端 
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点 /eureka/apps 轻松 检查 它 。 如 果 开 发 人 员 在 注册 客户 问 应 用 程序 后 立即 调用 它 ， 则 将 发 
现 它 仍 未 在 啊 应 中 返回 。30 秒 后 再 试 一 次 ， 即 可 看 到 新 实例 出 现 。 

可 以 使 用 responseCacheUpdateIntervalMs 属性 履 兰 啊 应 缓存 超时 。 有 趣 的 是 ， 使 用 
Eureka 仪表 板 显示 已 注册 实例 列表 时 却 没 有 缓存 。 因 为 它 与 REST API 相反 ， 它 绕 过 了 
啊 应 缓存 。 

Ee 


SeETFVEP: 
responseCacheUpdateIntervalMs: 3000 


开发 人 员 应 该 记 住 ，Eureka 注册 表 也 会 在 客户 端 缓存 。 因 此 ， 即 使 我 们 更 改 了 服务 
器 上 的 缓存 超时 ， 它 仍 可 能 需要 一 些 时 间 才 能 被 客户 端 刷新 。 默 认 情 况 下 ， 注 册 表 会 在 
每 30 秒 调 度 一 次 的 异步 后 台 任 务 中 定期 刷新 。 我 们 可 以 通过 声明 registryFetchInterval 
Seconds 属性 来 履 瘟 此 设置 。 与 最 近 一 次 获取 尝试 相 比 ， 它 仅 获 取 增 量变 化 。 可 以 使 用 
shouldDisableDelta 属性 禁用 此 选项 ,我们 已 经 在 服务 器 羡 和 客户 端 都 定义 了 3 秒 的 超时 ， 
此 时 如 果 使 用 /eureka/apps 设置 启动 示例 应 用 程序 ， 则 在 首次 尝试 时 将 可 能 显示 新 注册 的 
服务 实例 。 除 非 在 客户 端的 缓存 很 有 意义 ， 否 则 我 们 并 不 确定 服务 器 端 缓存 的 意义 ， 特 
别 是 考虑 到 Eureka 没有 任何 后 端 存 储 的 情况 下 。 残 个 人 而 言 ， 笔 者 从 来 没有 对 这 些 属性 
的 值 进行 过 任何 修改 ， 但 笔者 猜测 在 某 些 情况 下 它 也 可 能 很 重要 。 例 如 ， 开 发 人 员 使 用 
Eureka 开发 单元 测试 并 且 需 要 立即 啊 应 而 不 进行 缓存 。 

eureka: 

cient: 


reglistryFetchintervalSeconds: 3 
shouldDisableDelta: true 


4.4 启用 客户 端 和 服务 器 之 间 的 安全 通信 


到 目前 为 止 ，Eureka Server 没有 对 任何 客户 端的 连接 进行 过 身份 验证 。 在 开发 模式 
中 ， 安 全 性 并 不 像 生 产 模 式 那 么 重要 。 缺 乏 它 可 能 是 一 个 问题 。 我 们 希望 通过 基本 身份 
验证 保护 发 现 服务 器 ， 以 防止 未 经 授权 访问 任何 知道 其 网 络 地 址 的 服务 。 尽 管 Spring 
Cloud 参考 资料 声称 HTTP 基本 身份 验证 将 目 动 添加 到 Eureka 客户 疹 ， 但 开发 人 员 仍 必 
须 在 附属 项 目 中 包含 一 个 具有 安全 性 的 启动 器 。 


<dependency> 
<groupId>org.springframework.boot</grouplId> 
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<artifactId>spring-boot-starter-security</artifactId> 
</dependency> 
然后 ,， 开发 人 员 应 该 通过 更 改 application.yml 文件 中 的 配置 设置 来 启用 安全 性 , 并 且 
设置 默认 凭据 。 
security: 
basic: 
enabled: true 
USer: 
name: admin 
password: adminl23 
现在 ， 所 有 HTTP API 端点 和 Eureka 仪表 板 都 是 安全 的 。 要 在 客户 端 司 用 基本 号 份 
验证 模式 ， 应 在 URL 连接 地 址 中 提供 和 凭据， 如 以 下 配置 设置 中 所 示 。 实 现 安 全 及 现 的 示 
例 应 用 程序 可 在 同一 存储 库 (https://github.com/piomin/sample-spring-cloud-netflix.git〉 中 
找到 ， 并 且 可 用 作 基 本 示例 ， 但 开发 人 员 需 要 切换 到 security 分 文 (https:Wgithub.comy 
piomin/sample-spring-cloud-netflix/tree/security) 。 以 下 是 在 客户 疹 月 用 HTTP 基本 喘 份 验 
证 的 配置 。 
eureka: 
CIICenE: 
SeErVICEUTrL: 
defaultzone: http://admin:adminl23Q@localhost:87161/eurekal/ 


对 于 更 高 级 的 使 用 ， 如 在 发 现 客户 端 和 服务 器 之 间 使 用 证 书号 份 验证 方式 的 安全 
SSL 连接 ， 开 发 人 员 应 该 提供 DiscoveryClientOptionalArgs 的 自 定义 实现 。 在 本 书 第 12 
章 “ 你 护 API 的 安全 ”中 将 会 讨论 这 样 一 个 示例 ， 该 示例 将 致力 于 保护 Spring Cloud 应 
用 程序 的 安全 。 
保护 服务 器 端的 安全 性 是 一 回 事 ， 注 册 安 全 应 用 程序 则 是 另 一 回 事 。 现 在 让 我 们 来 
看 一 看 如 何 注 册 安 全 服务 。 
(1 ) 要 为 Spring Boot 应 用 程序 启用 安全 套 接 层 (Secure Sockets Layer，SSL) ， 需 
要 从 生成 和 目 签名 证 书 (Self-Signed Certificate) 开始 。 建 议 使 用 keytool， 它 可 以 在 bin 目 
录 中 的 JRE 根 目 录 下 使 用 。 
keytool -genkey -alias client 一 Storetype PRCS12 -kevyalg RSA 一 
keysilize 2048 一 Keystore keystore.pl2 validity 3650 
(2) 输入 所 需 数据 并 将 生成 的 密 钥 库 文 件 keystore.p12 复制 到 应 用 程序 的 src/maimy/ 
resources 目录 中 ， 而 接 下 来 的 步骤 则 是 使 用 application.yml 中 的 配置 属性 为 Spring Boot 
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启用 HITPS。 


人 

port: S${PORT:8081)} 

加 三 
key—store: classpath:keystore.pl2 
key—store—password: 123456 
kevStoreTvpe: PKCS12 
kevyAlias: client 


(3) 在 运行 应 用 程序 之 后 ， 开 发 人 员 应 该 能 够 调用 安全 端点 https://localhost:8761/ 
info。 此 时 还 需要 在 Eureka 客户 端 实例 配置 中 执行 一 些 更 改 。 

EUTEKa : 

jinstance: 
securePortEnabled: true 
nonSsSecurePortEnabled: false 
statusPageUrl: https://$s{eureka.hostname}:${server.port}/info 
healthCheckUrl: https://s{eureka.hostname} :$5${server.port}/health 
homePageUrl: https://${eureka.hostname}:${server.port}/ 


4.5 Eureka API 


Spring Cloud Netflix 提供 了 一 个 用 Java 编写 的 客户 端 ， 它 隐藏 了 开发 人 员 的 Eureka 
HTTP API。 如 果 开 发 人 员 使 用 除 Spring 之 外 的 其 他 框架 ， 则 Netflix OSS 提供 了 一 个 可 
以 作为 依赖 项 包含 的 普通 Eureka 客户 端 。 但 是 ， 开 发 人 员 很 容易 就 能 想到 一 些 需 要 直接 
调用 Eureka API 的 情况 。 例 如 ， 如 果 应 用 程序 是 使 用 除 Java 之 外 的 其 他 语言 编写 的 ， 或 
者 开发 人 员 在 持续 交付 (Continuous Delivery) 过 程 中 需要 已 广 册 服 务 列表 之 类 的 信息 ， 
这 些 都 需要 直接 调用 Eureka API。 表 4.1 提供 了 Eureka API 的 快速 参考 。 


表 4.1 Eureka API 快速 参考 


HTTP 端点 说 。 了 明 
POST /eureka/apps/appID 将 新 服务 实例 添加 到 注册 表 
DELETE /eureka/apps/appID/instanceID 从 注册 表 中 删除 服务 实例 
PUT /eureka/apps/appID/instanceID 器 服务 器 发 送 心跳 


获取 有 关 所 有 已 注册 服务 实例 列表 的 详 


GET /eureka/apps A 
EE 细 信 息 
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续 表 
as 说 阴 
GET /eureka/apps/appID 获取 有 关 特 定 服务 的 所 有 已 注册 实例 列 
表 的 详细 信息 
GET /eureka/apps/applID/instanceID 获取 有 关 单 个 服务 实例 的 详细 信息 


PUT /eureka/apps/appID/instanceID/metadata?key=value 更 新 元 数据 参数 
获取 有 关 具 有 特定 ID 的 所 有 已 注册 实例 
的 详细 信息 

PUT /eureka/apps/appID/instanceID/status? value=DOWN | 更 新 实例 的 状态 


GET /eureka/instances/instanceID 


4.6 副本 和 局 可 用 性 


前 文 已 经 讨论 了 一 些 有 用 的 Eureka 设置 ， 但 是 到 目前 为 止 ， 我 们 只 分 析 了 一 个 具有 
单 从 服务 发 现 服务 器 的 系统 。 这 样 的 配置 虽然 是 有 效 的 ， 但 仅 限 于 开发 模式 。 对 于 生产 
模式 来 说 ， 至 少 需要 运行 两 台 发 现 服务 器 ， 以 防 其 中 一 台 发 生 故 障 或 帮 生 网 络 问题 。 根 
据 定 义 ，Eureka 是 为 可 用 性 (Availability) 和 弹性 〈Resiliency) 而 构建 的 ， 这 是 Netflix 
开发 的 两 个 主要 文 柱 ， 但 它 不 提供 标准 的 集群 机 制 ， 如 领导 选举 或 目 动 加 入 集群 。 它 基 
于 对 等 复制 模型 。 这 意味 着 所 有 服务 器 都 复制 数据 并 将 心跳 发 送 到 所 有 对 等 体 ， 这 些 对 
等 体 在 当前 服务 器 节点 的 配置 中 设置 。 这 种 算法 对 于 包含 数据 简单 而 有 效 ， 但 它 也 有 一 
些 缺 点 。 它 限制 了 可 伸缩 性 ， 因 为 每 个 节点 都 必须 承受 服务 器 上 的 整个 写 入 负载 。 


4.6.1 样本 解决 方案 的 架构 


有 趣 的 是 ， 副 本 (Replication ) 机 制 是 开发 人 员 开 始 使 用 新 版 Eureka Server 的 主要 动 
机 之 一 。Eureka 2.0 目前 仍 在 积极 开发 中 。 除 了 优化 的 副本 机 制 之 外 ， 它 还 将 提供 一 些 有 
趣 的 功能 ， 如 从 服务 器 到 客户 端的 推送 模型 〈 用 于 推送 注册 列表 中 的 任何 更 改 ) 、 自 动 
扩展 的 服务 器 和 丰富 的 仪表 板 等 。 这 个 解决 方案 似乎 很 有 实践 意义 ， 但 Spring Cloud 
Netflix 使 用 的 仍然 是 版 本 1。 说 实话 ， 我 们 尚未 发 现任 何 迁 移 到 版 本 2 的 计划 ， 目 前 
Dalure.SR4 版 本 列车 的 Eureka 版 本 是 1.6.2。 服 务 露 端的 集群 机 制 的 配置 可 以 归结 为 一 件 
事 ， 即 使 用 eureka.client.* 属性 部 分 设置 男 一 个 发 现 服务 器 的 URL。 所 选 定 的 服务 器 将 
只 会 在 其 他 服务 器 中 注册 目 己 ， 而 这 些 服务 器 将 被 选 为 已 创建 集群 的 一 部 分 。 要 显示 该 
解决 方案 在 实践 中 的 工作 原理 ， 最 佳 方式 当然 是 通过 示例 。 
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现在 就 让 我 们 从 示例 系统 的 架构 开始 。 如 图 4.7 所 示 , 我 们 所 有 的 应 用 程序 都 将 在 不 
同 的 端口 上 以 本 地 方式 运行 ,在 此 阶段 , 我 们 必须 介绍 基于 Netflix Zuul 的 API 网 关 示 例 ， 
这 对 于 进行 负载 均衡 测试 是 有 帮助 的 。 本 示例 将 测试 在 不 同 区 域 (Zone) 中 注册 的 服务 
的 3 个 实例 之 间 的 负载 均衡 。 


上 Cateway #1 
localhost:-8765 


| App#2 | App #1 App #3 


localhost:8082 localhost-8081 | localhost-8083 


Eureka#2 |  , Eueka#! | , Eureka#3 
localhost:8762 localhost8/61 localhost8763 


图 4.7 示例 系统 架构 
4.6.2 构建 示例 应 用 程序 


对 于 Eureka Server 来 说 ， 可 以 在 配置 属性 中 定义 所 有 必需 的 更 改 。 在 application.yml 
文件 中 ， 我 们 为 发 现 服务 的 每 个 实例 定义 了 3 个 不 同 的 配置 文件 。 现 在 ， 如 果 要 尝试 运 
行 租 入 在 Spring Boot 应 用 程序 中 的 Eureka Server， 则 需要 通过 提供 VM 参数 -Dspring. 
profiles.active=peer[D] 来 激活 特定 的 配置 文件 ， 其 中 ， 上 是 实例 的 顺序 编号 。 


spring: 
Brofiles peerl 
eureka: 
instance: 
hostname: peerl 
metadataMap: 
ONe: ZONnel 
CI1ient: 
导 1 二 部 小 病 国 才 ) 二 和 属 < 
defaultz2one: 
http://localhost:8762/eureka/,http://localhost:817163/eureka/ 
eT 
port: Ss{PORT:81761)] 
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spring: 
profiles: peer2 
eureka: 
nstance.: 
hostname: peer2 
metadataMap: 
ONE: One 
client: 
eT er 
default2one: 
http://localhost:8761/eureka/,http://localhost:87163/eureka/ 
Server: 
port: S${PORT:8762] 


Spring: 
profiles: peer3 
eureka: 
instance: 
hostname: peer3 
metadataMap: 
ZONeE: ZONe3 
client: 
seryliceUrle 
defaultzZ2one: 
http://localhost:8761/eureka/,http://localhost:817162/eurekal/ 
Se 
port: S${PORT:8763} 


在 使 用 不 同 的 配置 文件 名 运行 所 有 3 个 Eureka 实例 后 ， 我 们 就 已 经 创建 了 一 个 本 地 
发 现 集群 。 如 果 在 启动 后 查看 任何 实例 的 Eureka 仪表 板 ， 那 么 它 看 起 来 始终 是 一 样 的 ， 
我 们 可 以 看 到 3 个 DISCOVERY-SERVICE 实例 ， 如 图 4.8 所 示 。 


DS Replicas 


Instances currently registered with Eureka 


Applicatdon 吕 症 |G Availanbiliny Zones SCArUs 


DISCOWERY-SERWICE nal3) (3} 


图 48 仪表 板 上 的 3 个 DISCOVERY-SERVICE 实例 


下 一 步 是 运行 客户 端 应 用 程序 。 项 目 中 的 配置 设置 与 使 用 Eureka Server 的 应 用 程序 
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的 配置 设置 非常 相似 。defaultZone 字段 中 提供 的 地 址 顺序 决定 了 对 不 同 肥 现 服务 的 连接 
答 试 的 顺序 。 如 条 无 法 建立 与 第 一 个 服务 器 的 连接 ， 那 么 它 将 委 试 从 列表 中 连接 第 二 个 
服务 器 ， 以 此 类 推 。 与 前 文 所 述 一 样 ， 开 发 人 员 应 该 设置 VM 参数 -Dspring.profiles.active = 
zone[n] 来 选择 正确 的 配置 文件 。 这 里 还 建议 设置 -Xmx192m 参数 。 请 记 住 ， 我 们 要 在 本 
地 测试 所 有 服务 ， 如 果 没 有 为 Spring Cloud 应 用 程序 设置 任何 内 存 限制 ， 则 启动 后 消耗 
大 约 350MB 的 堆 ， 并 且 总 的 内 存 使 用 大 约 为 600MB 。 除 非 计算 机 上 有 大 量 内 存 ， 人 否则 
很 难 在 本 地 机 器 上 运行 多 个 微服 务实 例 。 


spring: 
profiles: ZOnel 
eureka: 
已 下 于 己 企 在: 
Sery leedrle 

default2one: 
http://localhost:87161l/eureka/ ,http://localhost:87162/eureka/,http://localhost: 
8763/eureka/ 
SeTVeT : 

port: Ss5{PORT:808]1] 


SpIing: 

profiles: zone2 
SliTeks: 

Client: 

ServiceUrl: 
default2one: 

http://localhost:87162/eureka/,http://localhost:87161/eureka/,http://localhost: 
87163/eurekal/ 
SeTVeT : 

port: S${PORT:8082] 


spring: 

profiles: zone3 
eureka: 

C= eT 

SErPVICeEUTr]: 
default2one: 

http://localhost:8763/eureka/,http://localhost:8761/eureka/,http://localhost: 
8762/eureka/ 
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SeTVET : 
port: 5{f PORT:8083] 


现在 再 来 看 一 下 Eureka 仪表 板 。 尽 管 应 用 程序 最 初 只 连接 到 发 现 服务 的 一 个 实例 ， 
但 我 们 在 任何 地 方 都 注册 了 3 个 客户 端 服务 实例 。 无论 进入 哪个 上 发现 服务 实例 的 仪表 板 ， 
结果 都 是 相同 的 。 这 就 是 该 练习 的 确切 目的 。 现 在 可 以 创建 一 些 和 额外 的 实现 以 证 明 一 切 
都 已 如 预期 一 样 工 作 ， 如 图 4.9 所 示 。 


DS Replicas 


Instances currently registered with Eureka 


CLIENT-SERYVICE nala) (al 


MSCOVERY-SERVICE mal3) (3 


图 49 Eureka 仪表 板 


客户 靖 应 用 程序 除了 将 打印 所 选 配置 文件 名 称 的 REST 疹 点 公开 之 外 并 无 其 他 操作 。 
配置 文件 名 称 指向 特定 应 用 程序 实例 的 主 发 现 服务 实例 。 以 下 @RestController 实现 非常 
简单 ， 它 将 打印 当前 区 域 的 名 称 。 
QRestController 
public class ClientController 1 
QValue ("$5{spring.profiles}") 
private String Zone， 


RQGetMapping ("/ping"™") 
Public String ping(}) { 
return “I'm In Zone ”二 zone; 


} 


} 


最 后 ， 开 发 人 员 可 以 继续 实现 API 网 关 。 当 然 ， 详 细 介 绍 Zuul、Netflix 的 API 网 关 
和 路 由 器 提供 的 功能 超出 了 本 章 的 范围 《后 续 章 节 将 对 此 展开 详细 的 讨论 ) 。Zuul 现在 
将 有 助 于 测试 我 们 的 示例 解决 方案 ， 因 为 它 能 够 检索 在 发 现 服务 器 中 注册 的 服务 列表 ， 
并 在 客户 端 应 用 程序 的 所 有 正在 运行 的 实例 之 间 执 行 负载 均衡 。 正 如 以 下 配置 片段 所 示 ， 
开发 人 员 可 以 使 用 侦 听 端口 8763 的 发 现 服务 器 .所 有 包含 /apiclient**# 路 径 的 传 入 请 求 都 
将 路 由 到 client-service。 


zlL: 
prefix: /api 
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TOULeS : 

Pienks 
path: /client/** 
servicelId: client—-service 


eureka: 
clienkt: 
erviceUrl: 
defaultz2one: http://localhost:87163/eureka/ 
registerWithEureka: false 


现在 来 继续 进行 测试 。 开 上 有 人 员 可 以 使 用 java -jar 命令 局 动 Zuul 代理 (Proxy) 的 应 
用 程序 ， 与 以 前 的 服务 不 同 ， 这 次 不 需要 设置 任何 其 他 参数 ， 包 括 配置 文件 名 称 。 默 认 
情况 下 ， 它 将 与 编号 #3 的 发 现 服务 连接 。 要 通过 Zuul 代理 调用 客户 端 API， 开 发 人 员 
必须 在 Web 浏览 器 中 输入 以 下 地 址 http://localhost:8765/api/client/ping。 其 结果 如 图 4.10 
所 示 。 


一 Ilocalhost87657apirclientypin 其 如 


A Czesto odwiedzane 合 Galeria obiekt6w Web... 号 Pierwsze kroki Dy SuUgerowane Witryny 


T'm in zone zone3 


图 4.10 连接 到 编号 #3 的 发 现 服务 
如 果 连 续 多 次 重 试 请 求 ， 则 应 按 1:1:1 的 比例 在 所 有 现 有 client-service 实例 之 间 进 行 
负载 均衡 ， 尽 管 我 们 的 网 天 仅 连 接 到 编号 #3 的 发 现 服 务 。 此 示例 完整 演示 了 如 何 使 用 多 
个 Eureka 实例 构建 服务 友 现 。 
上 述 示例 应 用 程序 可 在 GitHub (https://github.com/piomin/sample-sprine-cloud-netflix.git) 
上 的 cluster 分 文 《https://github.com/piomin/sample-spring-cloud-Netflix/tree/cluster no zones ) 
中 获得 。 


4.6.3 ”故障 转移 


也 许 有 读者 会 问 ， 如 果 一 个 服务 发 现实 例 发 生 故 障 会 怎么 样 呢 ? 为 了 检查 集群 在 发 
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生 故 障 时 的 行为 方式 ， 不 妨 稍 微 修改 一 下 之 前 的 示例 。 现 在 ，Zuul 具有 一 个 故障 转移 
(Failover) 连接 ， 它 可 以 连接 到 其 配置 设置 中 设置 的 端口 8762 上 可 用 的 第 二 个 服务 发 现 。 
出 于 测试 目的 ， 可 以 关闭 端口 8763 上 可 用 的 第 三 个 发 现 服务 实例 。 

eureka: 

client: 
SeErviceUrl: 
default2one: 
http://localhost:8763/eureka/,http://localhost:817162/eureka/ 


registerWithEureka: ialse 

日前 的 情况 如 图 4.11 所 示 。 通 过 调用 http://localhost:8765/apiclient/ping 地 址 下 可 用 
的 网 关 疹 点 ， 可 以 按 与 先前 相同 的 方式 执行 测试 。 其 结果 也 与 之 前 的 测试 相同 ， 负 载 均 
衡 在 所 有 3 个 客户 端 服务 实例 中 按 预 期 平均 执行 。 虽然 已 禁用 发 现 服务 划 3， 但 是 其 他 两 
个 实例 仍然 能 够 相互 通信 ， 并 且 只 要 它 是 活动 的 ， 就 可 以 获得 有 关 从 实例 妈 复制 的 第 3 
个 客户 端 应 用 程序 实例 的 网 络 位 置 的 信息 。 现 在 ， 即 使 重新 启动 网 关 ， 它 仍然 能 够 按 顺 
序 使 用 第 二 个 地 址 连接 发 现 集群 (这 是 在 http://localhost:8762/eureka 的 defaultZone 字段 
中 设置 的 ) 。 这 同样 适用 于 客户 靖 应 用 程序 的 第 3 个 实例 ， 而 第 3 个 实例 又 会 将 发 现 服 
务 #] 作为 备份 连接 。 


Gateway #1 


本 localhost:8765 -a 


App #2 | #1 App #3 


localhost: 8082 | 而 8081 ~ localhost. 8083 


Eureka#2 Eureka #1 
localhost:8762 ) localhost:8761 


图 4.11 故障 转移 机 制 
4.7 区 域 


在 大 多 数 情况 下 , 基于 集群 (Cluster) 的 对 等 复制 模型 (Peer-to-Peer Replication Model) 
是 一 种 很 好 的 方式 ， 但 并 不 总 是 够 用 。Eureka 还 有 一 个 更 有 趣 的 功能 ， 在 集群 环境 中 非 
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常 有 用 。 事 实 上 ， 区 域 机 制 (Zone Mechanism) 是 其 默认 行为 。 即 使 开发 人 员 有 一 个 独 
了 的 服务 发 现实 例 ， 每 个 客户 端的 属性 也 必须 在 配置 设置 中 将 其 设置 为 eureka.client. 
seIViceUrldefaultZone。 这 在 什么 时 候 对 我 们 很 有 用 呢 ? 为 了 分 析 清 楚 ， 不 妨 回 到 第 4.6 
节 的 示例 。 假 设 现在 我 们 的 环境 分 为 3 个 不 同 的 物理 网 络 ， 或 者 只 有 3 台 不 同 的 机 器 处 
理 传 入 的 请 求 。 当 然 ， 发 现 服务 仍然 在 逻辑 上 分 组 在 集群 中 ， 但 每 个 实例 都 放 在 一 个 单 
独 的 区 域 中 。 每 个 客户 端 应 用 程序 都 将 在 与 其 主 发现 服 务 嚣 相同 的 区 域 中 注册 。 我 们 将 
启动 3 个 实例 《而 不 是 Zuul 网 关 的 一 个 实例 ) ， 每 个 实例 用 于 一 个 区 域 。 如 果 请 求 进入 
网 天 ， 那 么 它 所 选择 的 客户 端 应 该 在 尝试 调用 另 个 区 域 中 注册 的 服务 之 前 ， 优 先 利 用 
同一 区 域内 的 服务 。 如 图 4.12 所 示 是 当前 系统 架构 的 可 视 化 示意 图 。 当 然 ， 出 于 示例 目 
的 ， 该 架构 被 简化 为 能 够 在 单 台 本 地 机 器 上 运行 。 在 现实 世界 中 ， 正 如 前 文 所 述 ， 它 将 
在 3 台 不 同 的 机 器 上 运行 ， 甚 至 在 3 组 不 同 的 机 器 上 局 动 ， 从 物理 上 分 隔 为 其 他 网 络 。 


Gateway #2 8 Gateway #1 5 Gateway #3 
.ocalhost:8766 . localhost:8765 - localhost:B767 


App #2 . App #1 - 
.ocalhost:8082 ] - localhost:8081 : \ et s083 


| 了 加 工 


Eureka #2 -一 一 + Eureka #1 oo Eureka #3 
.ocalhost:8762 | 下 ”localhost:8761 上 一 一 localhost:8763 


Zone 1 : Ze 2 , Zone 4 


图 4.12 区域 机 制 简化 示意 
4.7.1 具有 独立 服务 器 的 区 域 


在 本 阶段 ， 我 们 应 该 强调 一 件 重 要 的 事情 ， 即 分 区 机 制 只 在 客户 端 实 现 。 这 意味 者 
服务 发 现实 例 未 指定 给 任何 区 域 。 因 此 ， 图 4.12 可 能 会 让 开发 人 员 略 微 产生 一 些 混 消 ， 
但 它 指出 了 哪个 Eureka 是 在 特定 区 域 中 注册 的 所 有 客户 问 应 用 程序 和 网 关 的 默认 服务 发 
现 。 我 们 的 目的 是 检查 高 可 用 性 模式 中 的 机 制 ， 但 我 们 也 可 以 仅 使 用 单个 发 现 服务 右 来 
构建 它 。 图 4.13 演示 了 与 图 4.12 类 似 的 情况 ,但 它 假定 所 有 应 用 程序 只 存在 一 个 发 现 服 
务 絮 。 
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one | mne 2 Iorej 


Gateway #2 
localhost:8766 


本 本 


Gateway #1 Gateway #3 
localhos::8765 localhost:8767 


加 加 


App #1 ee #3 
localhos::8081 localhost:8083 


、 | D> 


Eureka 
lOcalnosys/é61 一 


App 2 
me 8082 | 


图 4.13 具有 独立 服务 器 的 区 域 
4.7.2 ”构建 示例 应 用 程序 


要 局 用 区 域 处 理 机 制 ， 开 发 人 员 需 要 在 客户 端 和 网 关 的 配置 设置 中 执行 一 些 更 改 。 
以 下 是 客户 应 应 用 程序 中 修改 后 的 application.yml 文件 。 


SpIing: 
profijles: zonel 
eureka: 
1nstance: 
metadataMap: 
ZONeE: ZO0Nnel 
ClienE: 
eiceelyel: 
defaultz2one: 
http://localhost:876l/eurekal/,http://localhost:8762/eureka/,http://localhost: 
87163/eureka/ 


唯一 需要 更 新 的 是 eureka.instance.metadataMap.zone 属性 , 在 该 属性 中 可 以 设置 区 域 
的 名 称 和 已 经 注册 的 服务 。 

在 网 关 配 置 中 还 必须 进行 更 多 更 改 。 首 先 ， 需 要 添加 3 个 配置 文件 ， 以 便 能 够 运行 
在 3 个 不 同 的 区 域 和 3 个 不 同 的 发 现 服务 器 中 注册 的 应 用 程序 。 现 在 ， 在 启动 网 关 应 用 
程序 时 ， 开 发 人 员 应 该 设置 VM 参数 -Dspring.profiles.active = zone[n| 以 选择 正确 的 配置 
Ths 
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与 client-service 类 似 , 开发 人 员 还 必须 在 配置 设置 中 添加 eureka.instance.metadataMap. 
zone 属性 。 还 有 一 个 属性 eureka.client.preferSameZoneEureka 也 值得 一 提 ， 这 是 在 示例 中 
第 一 次 使 用 的 ， 如 果 网 关 应 该 优先 选择 在 同一 区 域 中 注册 的 客户 端 应 用 程序 的 实例 ， 则 
该 属性 必须 等 于 true。 


Spring: 
Brofiles: zonel 
eureka: 
cliient: 
ServiceUrl: 
defaultzone: http://localhost:817161/eurekal/ 
reglisterWithEureka: false 
preferSameaoneEureka: true 
instance: 
metadataMap: 
ONe: 20Nnel 
Server: 
port: S${PORT:8765] 


SpIring: 
profijles: zone2 
eureka: 
en 
SeryIiCeUrl: 
defaultz2zone: http://localhost:87162/eureka/ 
reglisterWithEureka: false 
preferSamesoneEureka: true 
instance: 
metadataMap: 
ONeE: ZONe2 
SErLVer: 
port: ${PORT:8766] 


SpIring: 
profiles: zone3 
eureka: 
lienk: 
ST 
defaultzone: http://localhost:87163/eurekal/ 
reglsterWithEureka: false 
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PITefteTrSame2oneEUTreKa: true 
instance: 
metadataMap: 
ZONE: ZONEe3 
SE 
port: 5{PORT:8767) 


在 启动 发 现 、 客 户 端 和 网 关 应 用 程序 的 所 有 实例 后 ， 开 发 人 员 可 以 尝试 调用 在 
http://localhost:8765/apy/client/ping 、 http://localhost:8766/apy/client/ping 和 http://localhost: 
8767/api/client/ping 地 址 下 可 用 的 端点 。 它 们 中 的 每 一 个 都 将 始终 与 在 同一 区 域 中 注册 的 
客户 端 实 例 进行 通信 。 因 此 ， 与 没有 首选 区 域 的 测试 不 同 ， 端 口 8765 下 可 用 的 第 一 个 网 
关 实 例 将 始终 在 调用 ping 端点 时 显示 Im in zone zonel， 如 图 4.14 所 示 。 


是 | localhost8765/api/client/pir * ™ 


(0) localhost8765/api/dlient/ping 
a) Czesto odwiedzane 仿 Galeria obiekt6w Web... 虱 | pierwsze kroki 十 Sugerowane witryny 


Im in zone zonel 


4.14 ”区域 处 理 机 制 将 始终 选择 相同 区 域 的 客户 端 实例 


当 客 户 病 编写 #1 不 可 用 时 会 发 生 什么 呢 ? 传 入 请 求 将 在 客户 端 应 用 程序 的 两 个 其 他 
实例 之 则 进行 50/50 的 负载 均衡 ， 因 为 它们 都 位 于 与 网 关 #1 不 同 的 区 域 中 。 


4.8 小 结 


本 章 首 次 使 用 了 Spring Cloud 开发 应 用 程序 。 在 笔者 看 来 ， 学 习 使 用 微服 务 框架 的 
最 佳 方法 是 尝试 了 解 如 何 正 确实 现 服务 发 现 。 本 章 从 最 简单 的 用 例 和 示例 开始 ， 全 面 介 
绍 了 Netflix OSS Eureka 项 目 提 供 的 高 级 功能 和 可 直接 应 用 于 生产 模式 的 功能 。 本 章 展示 
了 如 何在 5 分 钟 内 创建 和 运行 基本 客户 端 和 独立 发 现 服务 器 。 基 于 该 实现 ， 本 章 还 介绍 
本 如 何 自 定义 Eureka 客户 端 和 服务 器 以 满足 开发 人 员 的 特定 需求 ， 并 且 重 点 讨论 了 网 络 
或 应 用 程序 故障 等 负面 情况 的 应 对 。 本 章 还 详细 讨论 了 REST API 或 用 户 界面 仪表 板 等 功 
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能 。 最 后 ， 本 章 还 演示 了 如 何 使 用 Eureka 的 机 制 〈 如 副本 、 区 域 和 高 可 用 性 等 ) 创建 可 
用 于 生产 模式 的 环境 。 有 了 这 些 知识 ， 开 发 人 员 就 应 该 能 够 正确 选择 Eureka 的 功能 ， 并 
通过 这 些 功能 构建 适应 基于 微服 务 架构 要 求 的 服务 发 现 。 

在 掌握 了 服务 发 现 之 后 ， 开 发 人 员 即 可 进入 基于 微服 务 的 体系 结构 中 的 下 一 个 基本 
元 素 ， 即 配置 服务 器 。 发 现 和 配置 服务 通常 都 基于 键 / 值 存 储 ， 因 此 它们 可 以 使 用 相同 的 
产品 提供 。 但 是 , 由 于 Eureka 仅 专 注 于 友 现 , 所 以 Spring Cloud 引入 了 目 己 的 框架 Spring 
Cloud Config 来 管理 分 布 式 配 置 。 


第 5 章 使 用 Spring Cloud Config 
进行 分 布 式 配置 


现在 是 在 我 们 的 架构 中 引入 新 元 素 的 最 佳 时 机 ， 这 个 新 元 素 就 是 分 布 式 配 置 服务 器 
(Distributed Configuration Server)。 与 服务 发 现 类 似 ， 这 是 围绕 微服 务 的 关键 概念 之 一 。 
在 本 书 第 4 章 中 ， 已 经 详细 讨论 了 如 何在 服务 器 端 和 客户 端 上 准备 发 现 。 但 是 到 目前 为 
止 ， 我 们 始终 是 使 用 放置 在 胖 JAR 文件 中 的 属性 为 应 用 程序 提供 配置 。 这 种 方法 有 一 个 
很 大 的 缺点 ， 那 束 是 它 需 要 重新 编译 和 重新 部 署 微 服务 的 实例 。Spring Boot 文 持 男 一 种 
方法 , 它 假 定 使 用 存储 在 胖 JAR 之 外 的 文件 系统 中 的 显 式 配置 .使 用 spring.config.location 
属性 可 以 在 启动 期 间 为 应 用 程序 轻松 配置 它 。 这 种 方法 不 需要 重新 部 署 ， 但 它 也 不 是 没 
有 缺点。 在 使 用 大 量 微服 务 的 情况 下 ， 基 于 放置 在 文件 系统 中 的 显 式 文件 的 配置 管理 可 
能 真 的 很 腑 烦 。 另 外 ， 如 果 每 个 微服 务 都 有 很 多 实例 ， 而 每 个 实例 又 都 有 一 个 特定 的 配 
置 。 那 么 ， 采 用 这 种 方法 的 碟 燃 程度 简直 不 敢 想 象 。 

无 论 如 何 , 分 布 式 配置 是 云 原 生 环 境 中 非常 流行 的 标准 。Spring Cloud Config 可 以 为 
分 布 式 系 统 中 的 外 部 化 配置 提供 服务 器 喘 和 客户 疹 文 持 。 通 过 该 解雇 方案， 开发 人 员 可 
以 在 一 个 中 心 位 置 管理 所 有 环境 中 的 应 用 程序 的 外 部 属性 。 这 个 概念 非 间 简单， 而 且 易 
于 实现 。 服 务 器 只 是 公开 HTTP 和 基于 资源 的 API 接口 ， 它 们 将 以 JSON、YAML 或 
properties 格式 返回 property 文件 。 此 外 ， 它 还 会 对 返回 的 属性 值 执 行 解密 和 加 密 操 作 。 
客户 病 需 要 从 服务 器 获取 配置 设置 ， 并 有 旦 如 果 在 服务 器 问 启 用 了 加 密 之 类 的 功能 ， 则 客 
户 端 还 需要 对 它们 进行 解密 处 理 。 

配置 数据 可 以 存储 在 不 同 的 存储 库 (Repository) 中。EnvironmentRepository 的 默认 
实现 将 使 用 Git 后 疹 (Backend) 。 也 可 以 设置 其 他 版 本 控制 系统 (Version Control System， 
VCS) ， 如 SVN。 如 果 开 发 人 员 不 想 利用 VCS 系统 提供 的 功能 作为 后 端 ， 则 可 以 使 用 文 
件 系 统 或 Vault。Vault 是 一 种 用 于 管理 机 密 的 工具 ， 它 可 以 用 于 存储 和 控制 对 令 牌 、 密 
码 、 证 书 和 API 密 钥 等 资源 的 访问 。 

本 章 将 要 讨论 的 主题 包括 : 

DD 由 Spring Cloud Config Server 公开 的 HITP API。 

口 ” 服 务 堪 端的 不 同类 型 的 存储 库 后 端 。 

口 与 服务 发 现 集成 。 


口 ”使 用 Spring Cloud Bus 和 消息 代理 自动 重新 加 载 配置 。 
5.1 HTTP API 资 源 简介 


Config Server 将 提供 HITP API， 它 可 以 通过 各 种 方式 调用 。 以 下 端点 都 是 可 用 的 。 
口 。/{application}/{profile}[/{label}]: 以 JSON 格式 返回 数据 ; label 参数 是 可 选 的 。 
口 /fapplicationy-fprofiley.yml: 返回 YAML 格式 。 
口 /flabel}/{fapplication}-{fprofile}.yml: 这 是 前 一 个 端点 的 变 体 ， 开 发 人 员 可 以 传递 
一 个 可 选 的 label 参数 。 

口 /fapplication}-{fprofiley.properties: 返回 properties 文件 使 用 的 简单 键 / 值 格式 。 

口 /flabelY/{application}-{profileY.properties: 这 是 前 一 个 痛 点 的 变 体 ， 开 发 人 员 可 
以 传递 一 个 可 选 的 label 参数 。 

从 客户 端的 角度 来 看 ，application 参数 是 应 用 程序 的 名 称 ， 它 取 目 spring.application 
name 或 spring.config.name 的 属性 ,profile 是 活动 配置 文件 或 以 逗号 分 隔 的 活动 配置 文件 
列表 。 最 后 一 个 可 用 的 参数 label 是 一 个 可 选 属性 ， 只 有 在 使 用 Git 作为 后 端 存 储 时 才 很 
重要 。 它 将 设置 Git 分 文 的 名 称 以 进行 配置 ， 默 认为 master。 

现在 可 以 从 最 简单 的 基于 文件 系统 后 端的 例子 开始 。 默 认 情 况 下 ，Spring Cloud 
Config Server 将 尝试 从 Git 存储 库 获 取 配 置 数 据 。 要 启用 原生 配置 文件 ， 开 发 人 员 应 该 将 
spring.profiles.active 选项 设置 为 native 来 启动 服务 器 。 它 将 搜索 存储 在 以 下 位 置 的 文件 : 
classpath:/、classpath:/config、file:./、file:./config。 这 意味 着 properties 或 YAML 文件 也 可 
以 放 在 JAR 文件 中 。 为 测试 起 见 ， 我 们 已 经 在 src/main/resources 中 创建 了 一 个 config 文 
件 夹 。 我 们 的 配置 文件 将 存储 在 该 位 置 中 。 现 在 需要 回 到 本 书 第 4 章 的 示例 中 。 在 第 4 
章 中 已 经 介绍 了 集群 发 现 环境 的 配置 ， 该 环境 中 的 每 个 客户 端 服务 实例 都 在 不 同 的 区 域 
中 启动 。 它 有 3 个 可 用 区 域 和 3 个 客户 端 实例 ,每 个 实例 都 在 application.yml 文件 中 有 日 
己 的 配置 文件 。 该 示例 的 源 代 码 在 config 分 文中 可 用 ， 以 下 是 其 链接 。 


https://github.com/piomin/sample-spring-cloud-netflix/tree/config 


我 们 当前 的 任务 是 将 该 配置 迁移 到 Spring Cloud Config Server。 这 里 不 妨 自 我 提醒 一 
下 这 个 示例 的 属性 。 以 下 是 用 于 客户 端 应 用 程序 的 第 一 个 实例 的 配置 文件 设置 。 根 据 所 
选 的 配置 文件 ， 有 一 个 修改 实例 运行 的 端口 、 默 认 发 现 服务 器 URL 和 区 域名 称 。 


spring: 
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profiles: zonel 


eureka: 
instance: 
metadataMap: 
zone: zonel 
client: 
ServiceUrl|: 
defaultzone: http://localhost:817161l/eurekal/ 


SeErVer: 
port: ${PORT:8081] 


在 前 面 所 介绍 的 示例 中 , 为 简单 起 见 , 己 经 将 所 有 配置 文件 设置 放 在 单个 application.yml 
文件 中 。 该 文件 也 可 以 分 为 3 个 不 同 的 文件 ， 其 名 称 包括 配置 文件 application-zonel.yml、 
application-zone2.yml 和 application-zone3.yml。 当 然 ， 这 样 的 名 称 对 于 单个 应 用 程序 来 说 
是 唯一 的 ， 因 此 ， 如 果 决 定 将 文件 移动 到 远程 配置 服务 器 中 ， 则 应 该 注意 它们 的 名 称 。 
客户 端 应 用 程序 名 称 是 从 spring.application.name 注入 的 ， 在 这 种 情况 下 ， 它 是 client- 
seIvice。 因 此 ， 总 而 言 之 ， 笔 者 已 经 在 src/main/resources/config 目录 中 创建 了 名 为 client- 
service-zone[n].yml 的 3 个 配置 文件 ， 其 中 ，[n] 是 实例 的 编号 。 现 在 ， 当 开发 人 员 调 用 
http://localhost:8888/client-service/zonel 端点 时 ， 将 接收 到 以 下 JSON 格式 的 啊 应 。 


{ 

"name":"client-service", 

"profiles":["zonel"™"], 

"label"™"™ :null, 

"version"™ :null, 

ns 七 ate" :mull ， 

"propertySources"™:[{ 
"name":"classpath:/config/client-service-zonel .vyml", 
Tsource"™:1 

"eureka.instance.metadataMap .zone"™:"zonel", 
"eureka .client.serviceUrl.defaultzone":"http://localhost:8761/eureka/", 
"server.port":"${PORT: 8081}" 
} 
}] 
} 


还 可 以 为 第 二 个 实例 调用 http://localhost:8888/client-service-zone2.properties， 它 将 以 
下 啊 应 作为 属性 列表 返回 。 
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eureka.client.serviceUrl.defaultZzone: http://localhost:8762/eurekal/ 
eureka.instance.metadataMap .zone : zone2z 
server.port: 8082 


HTTP API 冰点 的 最 后 一 个 可 用 版 本 http:Wlocalhost:8889/client-service-zone3.yml 将 返 
回 与 输入 文件 相同 的 数据 。 以 下 是 第 三 个 实例 的 结果 。 
eureka: 
client: 
ServiceUrl: 
defaultZzZone: http://localhost:8763/eurekal/ 
instance: 
metadataMap: 
Zone : Zone3 


Server: 
port: 8083 


5.2 ”构建 服务 器 端 应 用 程序 


在 第 5.1 节 中 己 经 讨论 了 HTTP API (一 种 由 Spring Cloud Config Server 提供 的 基于 
资源 的 API) ， 以 及 通过 它 创建 和 存储 属性 的 方法 。 现 在 我 们 需要 回归 到 基础 方法 。 与 
发 现 服务 器 相同 ，Config Server 可 以 作为 Spring Boot 应 用 程序 运行 。 要 在 服务 器 端 启 用 
它 ， 应 该 在 pom.xml 文件 的 依赖 项 中 包含 spring-cloud-config-server。 

<dependency> 

<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-config-server</artifactId> 

</dependency> 

除 此 之 外 ， 开 发 人 员 还 应 该 在 主 应 用 程序 类 上 启用 Config Server。 将 服务 器 端口 更 
改 为 8888 是 一 个 好 主意 , 因为 客户 端 上 spring.cloud.config.uri 属性 的 默认 值 也 是 8888 站 
口 。 当 然 ， 这 里 说 的 是 它 在 客户 端 上 自动 配置 时 的 情况 。 要 将 服务 器 切换 到 不 同 的 端口 ， 
则 应 该 将 server.port 属性 设置 在 8888 端口 上 ， 或 者 使 用 spring.config.name= configserver 
属性 来 启动 它 。 下 面 是 一 个 在 spring-cloud-config-server 库 中 骨 入 的 configserver.yml。 

QSspringBootApplication 


QEnableConfigServer 
public class ConfigApplication { 


第 5 章 使 用 Spring Cloud Config 进行 分 布 式 配置 * 87。 


Public static void main (Stringl||] args} 1 
New 
SpringApplicationBuilder (ConfijgApplication.class)}) .web (true) .run(args); 


} 


5.3 ”构建 客户 端 应 用 程序 


如 果 将 端口 8888 设置 为 服务 器 的 默认 端口 ， 则 客户 端的 配置 就 会 变 得 非常 简单 。 开 
发 人 员 需 要 做 的 就 是 提供 包含 应 用 程序 名 称 的 bootstrap.yml 文件 ， 并 在 pom.xml 中 包含 
以 下 依赖 项 。 当 然 ， 该 规则 仅 适 用 于 localhost， 因 为 客户 端 上 自动 配置 的 Config Server 地 
址 就 是 http://localhost:8888。 

<dependency> 

<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-starter-—config</artifactId> 

</dependency> 

如 果 为 服务 器 设置 了 不 同 于 8888 的 端口 , 或 者 它 在 与 客户 端 应 用 程序 不 同 的 计算 机 
上 运行 ， 则 还 应 在 bootstrap.yml 中 设置 其 当前 地 址 。 以 下 是 Bootstrap 的 上 下 文 设置 ， 它 
允许 开 友 人 员 从 端口 8889 上 可 用 的 服务 器 获取 client-service 的 属性 。 当 使 用 --spring. 
profiles.active=zonel 参数 运行 该 应 用 程序 时 , 它 会 日 动 获取 配置 服务 器 中 为 zonel 配置 文 
件 设置 的 属性 。 

Spring: 

application: 
name: client—service 
cloud: 
CoOn 土 1 可 : 
uri: http://localhost:8889 

开发 人 员 可 能 已 经 注意 到 ， 客 户 端 属性 中 存在 发 现 服务 网 络 位 置 的 地 址 。 因 此 ， 在 
启动 客户 端 服务 之 前 ， 应 该 运行 Eureka Server。 当 然 ，Eureka 也 有 它 自己 的 配置 ， 并 且 
己 经 存储 在 application.yml 文件 中 , 这 在 第 4 章 的 示例 中 己 有 说 明 。 与 client-service 类 似 ， 
该 配置 已 分 为 3 个 配置 文件 ， 其 中 ， 每 个 配置 文件 在 服务 器 的 HTTP 端口 的 数量 和 要 与 
之 通信 的 发 现 对 等 体 列表 等 属性 上 都 不 同 。 

现在 ， 可 以 将 这 些 property 文件 放 在 配置 服务 器 上 。Eureka 将 在 局 动 时 获取 分 配给 
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所 选 配 置 文件 的 所 有 设置 。 文 件 命 名 与 已 描述 的 标准 一 至， 这 意味 着 它 应 该 是 discovery- 
service-zone[nl].yml。 在 运行 Eureka Server 之 前 ， 应 该 在 依赖 项 中 包含 spring-cloud-starter- 
config 以 启用 Spring Cloud Config Client， 并 将 application.yml 蔡 换 为 bootstrap yml， 如 下 
所 示 。 
Spring: 
application: 
name: discovery—Service 
cloud: 
config: 
uri: http://localhost:8889 
接 下 来 ， 可 以 通过 在 --spring.profiles.active 属性 中 设置 不 同 的 配置 文件 名 称 ， 以 对 等 
通信 模式 运行 Eureka Server 的 3 个 实例 。 局 动 3 个 客户 端 服 务实 例 后 ， 我 们 的 架构 将 如 
图 5.1 所 示 。 与 第 4 章 中 的 示例 相 比 ， 这 里 的 客户 端 和 发 现 服务 都 从 Spring Cloud Config 
Server 获取 配置 ， 而 不 是 将 其 保存 为 胖 JAR 中 的 YML 文件 。 


Ento eerwas cone ymil 


可 于 电 
到 于 | 


App #2 App #1 | App #3 | 
localhost:8082 | localhost:8081 lpcalhost:8083 


| 


Eureka #2 ~ Eurekapl .Eurekan3 
localhost:8762 “ ™ localhost:8761 localhost:876) 
9 a 日 _ 二 
lient-service-zmne? ym “~. discovery.sbrvire-zone?} rml >。 本 有 discovery.ceryied. 7hne} Yamil a client -LET VICe.Z0nes. yml 
me A scovere sernvice- zmel yml a i 
上 = e” 


_ ConTig Server 
localhast:SB89 


5.1 启动 3 个 客户 端 服务 实例 之 后 的 架构 
5.4 和 客户 端 引导 方法 
在 之 前 介绍 的 示例 解决 方案 中 ， 所 有 应 用 程序 都 必须 保持 配置 服务 器 的 网 络 位 置 。 


服务 发 现 的 网 络 位 置 将 作为 属性 存储 在 其 中 。 在 这 一 点 上 ， 开 发 人 员 面 临 着 一 个 需要 讨 
论 的 有 趣 问题 。 这 个 问题 是 : 我 们 的 微服 务 是 否 应 该 知道 Config Server 的 网 络 地 址 ? 在 
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之 前 的 讨论 中 我 们 同意 这 个 结论 : 对 于 所 有 服务 的 网 络 位 置 来 说 ， 应 保留 的 主要 位 置 是 
服务 发 现 服务 器 。 配 置 服务 器 和 其 他 微服 务 一 样 ， 也 是 Spring Boot 应 用 程序 ， 因 此 从 风 
辑 上 讲 ， 它 应 该 同 Eureka 注册 它 自 己 ， 以 便 为 必须 从 Spring Cloud Config Server 获取 数 
据 的 其 他 服务 局 用 上 自动 友 现 机 制 。 这 反 过 来 要 求 将 服务 及 现 连接 设置 放 在 bootstrap.yml 
中 ， 而 不 是 放 在 spring.cloud.config.uri 属性 中 。 

在 这 两 种 不 同方 法 之 间 进 行 选择 ， 是 开发 人 员 在 设计 系统 架构 时 需要 做 出 的 决策 之 
一 。 这 里 的 意思 并 不 是 说 一 个 解决 方案 就 一 定 比 另外 一 个 解决 方案 更 好 。 对 于 任何 使 用 
spring-cloud-config-client 工件 的 应 用 程序 来 说 , 其 默认 行为 在 Spring Cloud 术语 中 被 称 为 
配置 优先 引导 (Config First Bootstrap) 。 当 配置 客户 端 局 动 时 ， 它 会 绑 定 到 服务 露 并 使 
用 远程 属性 源 初始 化 上 下 文 。 这 个 解决 方案 在 本 章 介 绍 的 第 一 个 示例 中 己 经 有 所 体现 。 
在 第 二 个 解决 方案 中 ，Config Server 将 注册 服务 发 现 ， 并 且 所 有 应 用 程序 都 可 以 使 用 
DiscoveryClient 来 定位 它 。 这 种 方法 被 称 为 发 现 优 先 引 导 (Discovery First Bootstrap ) 。 
接 下 来 我 们 将 通过 一 个 具体 示例 来 说 明 这 个 概念 。 

要 访问 GitHub 上 的 这 个 示例 ， 开 发 人 员 需 要 切换 到 config with_discovery 分 文 。 以 
下 是 其 链接 地 址 。 

https://github.com/piomin/sample—-spring-cloud-netflix/tree/confiqg with 

discovery. 

第 一 个 更 改 与 sample-service-discovery 模块 有 关 。 在 本 示例 中 ， 开 发 人 员 不 需要 
spring-cloud-starter-config 依赖 ， 因 为 其 简单 配置 并 不 是 从 远程 属性 源 获 取 ， 而 是 在 
bootstrap.yml 中 设置 的 。 与 前 面 的 示例 不 同 ， 这 里 我 们 启动 了 一 个 独立 的 Eureka 实例 ， 
以 简化 练习 。 

Spring: 

application: 
name: dlscovery—Service 


ST 
port: S${PORT:8761] 


eureka: 

全 下 工人 芋 到 在 
registerWithEureka: false 
fetchReglistry: false 


与 前 面 的 示例 相 比 还 有 一 个 不 同 ， 那 就 是 开发 人 员 应 该 为 Config Server 包含 
spring-cloud-starter-eureka 依赖 项 。 现 在 ， 完 整 的 依赖 项 列表 显示 在 以 下 代码 中 。 此 外 ， 
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必须 通过 在 主 类 上 声明 @EnableDiscoveryClient 注释 来 启用 发 现 客户 端 ， 并 且 应 通过 在 
application.yml 文件 中 将 eureka.client.serviceUrl.defaultZone 属性 设置 为 http://localhost: 
8761/eureka/ 来 提供 Eureka 服务 器 地 址 。 
<dependency> 
<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 
<dependency> 
<groupId>org.springframework.cloud</groupld> 
<artifactId>spring-cloud-starter-eureka</artifactId> 
</dependency> 
在 客户 疹 应 用 程序 中 ， 不 再 需要 保存 配置 服务 器 的 地 址 ， 唯 一 要 做 的 事情 便 是 设置 
服务 也 ， 以 防 它 与 Config Server 不 同 。 根 据 以 上 示例 中 用 于 服务 的 命名 约定 ， 该 ID 应 
该 是 config-server。 它 应 该 补 spring.cloud.config.discovery.serviceId 属性 履 新 。 为 了 允许 
发 现 机 制 局 用 ， 使 得 发 现 机 制 可 以 从 配置 服务 右 获 取 远 程 属性 源 ， 开 发 人 员 应 该 设置 
spring.cloud.config.discovery.enabled=true.。 
SpIring: 
application: 
name: client—service 
Cloud: 
config: 
discovery: 


enabled: true 
Serviceld: Config— server 


图 5.2 是 包含 Eureka 仪表 板 的 屏 医 截图 ， 其 中 有 一 个 Config Server 的 实例 和 3 个 已 
经 注册 的 client-service 实例 。 该 客户 端的 Spring Boot 应 用 程序 的 每 一 个 实例 都 与 上 一 个 
示例 相同 ， 并 且 使 用 了 -- spring.profiles.active=zone[n| 参 数 启 动 ， 其 中 , n 是 区 域 的 编号 。 
唯一 的 区 别 是 Spring Cloud Config Server 提供 的 所 有 客户 端 服务 配置 文件 都 县 有 与 
Eureka Server 相同 的 连接 地 址 。 


Instances currently registered with Eureka 


Application ahs avwailability Zones Ciatbus 


CUENT-SERVICE mal3) (3) UP (3) -= minkewe-l.pd.org:client-service: 


tONFIG-SERVER malli) [相间 | UP (1) = minkawp-l.pd.corg:contig-5erver:Ssad 


5.2 Eureka 仪表 板 屏幕 截图 
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5.5 存储 库 后 端 类 型 


在 本 章 中 ， 之 前 的 所 有 示例 都 使 用 了 文件 系统 后 端 ， 这 意味 着 配置 文件 是 从 本 地 文 
件 系 统 或 类 路 径 加 载 的 。 这 种 类 型 的 后 端 非 常 适 合 教程 或 测试 。 但 是 ， 如 果 要 在 生产 模 
式 中 使 用 Spring Cloud Config， 则 需要 考虑 其 他 选项 。 第 一 个 是 基于 Git 的 存储 库 后 端 
(Repository Backend) ， 并 且 在 默认 情况 下 也 会 局 用 它 。 当 然 ， 它 并 不 是 唯一 可 用 作 配 
置 源 存储 库 的 版 本 控制 系统 (Version Control System，VCS) 。 

另 一 个 选项 是 SVN( 它 是 Subversion 的 简称 ， 这 也 是 一 个 开放 源 代 码 的 版 本 控制 系 
统 ) 。 或 者 ， 开 发 人 员 还 可 以 考虑 创建 一 个 复合 坏 境 ， 它 可 能 同时 包含 Git 和 SVN 存储 
库 。 下 一 个 受 文 持 的 后 端 类 型 是 Vault， 它 基于 由 HashiCorp 提供 的 工具 。 在 管理 密码 或 
证 书 等 安全 属性 时 尤其 有 用 。 接 下 来 我 们 将 详细 讨论 每 一 个 解决 方案 。 


5.5.1 文件 系统 后 端 


关于 文件 系统 后 端的 内 容 ， 其 实在 前 面 的 示例 中 已 经 讨论 过 很 多 了 。 所 有 这 些 示 例 
都 展示 了 如 何在 类 路 径 中 存储 属性 源 ， 并 且 还 可 以 从 磁盘 加 载 它 们 。 默 认 情 况 下 ，Spring 
Cloud Config Server 会 尝试 在 应 用 程序 的 工作 目录 或 此 位 置 的 config 子 目 录 中 查找 文件 。 
开发 人 员 可 以 使 用 spring.cloud.config.server.native.searchLocations 属性 窗 新 默认 位 置 。 搜 
索 位 置 路 径 可 能 包含 application、profile 和 label 等 占 位 符 。 如 果 在 位 置 路 径 中 没有 使 用 
任何 占 位 符 ， 则 存储 库 会 自动 将 label 参数 附加 为 后 级。 

因此 ， 配 置 文件 将 从 每 个 搜索 位 置 和 与 label 参数 同名 的 子 目 录 加 载 。 这 意味 着 
file:/home/example/config 与 file:/home/example/config、 file:/home/example/config/ {label! 十 
相同 的 。 通 过 将 spring.cloud.config.server.native.addLabelLocations 设置 为 false 可 以 禁用 
此 行为 。 

正如 前 文 所 述 ， 文 件 系 统 后 端 不 是 生产 部 署 的 好 选择 。 如 果 将 属性 源 放 在 JAR 文件 
内 的 类 路 径 中 ， 则 每 次 更 改 都 需要 重新 编译 应 用 程序 。 另 外 ， 使 用 JAR 之 外 的 文件 系统 
虽然 不 需要 重新 编译 ， 但 如 果 在 高 可 用 性 模式 下 有 多 个 配置 服务 实例 ， 则 此 方法 可 能 会 
很 及 烦 。 在 这 种 情况 下 ， 需 要 路 所 有 实例 共享 文件 系统 或 保存 每 个 运行 实例 的 所 有 属性 
源 的 副本 。Git 后 端 束 没有 这 些 缺 点 ， 这 也 是 它 被 推荐 用 于 生产 模式 的 原因 。 
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5.5.2 ”Git 后 端 


Git 版 本 控制 系统 具有 的 一 些 功 能 ,使 其 作为 属性 源 的 存储 库 非 常 有 用 。 它 允许 开发 

人 员 轻 松 管理 和 审核 更 改 。 通 过 使 用 众所周知 的 VCS 机 制 ， 如 提交 〈Commit) 、 还 原 
(Revert) 和 分 文 (Branch) ， 开 发 人 员 可 以 比 使 用 文件 系统 方法 更 轻松 地 执行 重要 操作 。 

这 种 类 型 的 后 靖 还 有 另外 两 个 关键 优势 。 它 会 强制 在 Config Server 源 代 伺 和 property 文 
件 存 储 库 之 间 产 生 分 离 。 如 果 开 发 人 员 再 看 一 裔 前 面 的 示例 ， 就 会 发 现 这 些 示 例 的 
property 文件 是 与 应 用 程序 源 代 码 一 起 存储 的 。 

可 能 有 些 人 会 说 ， 即 使 开发 人 员 使 用 的 是 文件 系统 后 端 ， 也 可 以 将 整个 配置 作为 一 
个 单独 的 项 目 存 储 在 Git 上 , 并 根据 需要 将 其 上 传 到 远程 服务 器 。 这样 说 固然 没 错 , 但 是 ， 
如 果 能 与 Spring Cloud Config 一 起 使 用 Git 后 端 ， 则 可 以 使 用 现成 的 有 效 机 制 , 何 乐 而 不 
为 呢 ?” 此 外 , 它 还 解决 了 与 运行 多 个 服务 器 实例 相关 的 问题 。 如 果 使 用 的 是 远程 Git 服务 
器 ， 则 可 以 在 所 有 正在 运行 的 实例 中 轻松 共享 更 改 。 

1. 不 同 的 协议 

要 为 应 用 程序 设置 Git 存储 库 的 位 置 ， 可 以 使 用 application.yml 中 的 spring.cloud. 
config.server.git.uri 属性 。 如 果 开 发 人 员 熟 悉 Git， 则 应 该 很 清楚 地 知道 ， 可 以 使 用 file、 
http/https 和 ssh 协议 实现 克隆 ,对 本 地 存储 库 的 访问 允许 开发 人 员 在 没有 远程 服务 器 的 情 
况 下 快速 开始 。 它 可 以 使 用 flle 前 级 进行 配置 ， 如 spring.cloud.config.server.git.uri=file:/ 
home/git/config-repo。 要 在 高 可 用 性 模式 下 运行 Config Server (这 是 更 高 级 的 用 法 ) ， 则 
可 以 使 用 SSH 或 HTTPS 远程 协议 。 在 这 种 情况 下 ，Spring Cloud Config 将 克隆 远程 存储 
库 ， 并 在 此 基础 上 使 用 本 地 工作 副本 作为 缓存 。 

2. 在 URI 中 使 用 占 位 符 

这 里 还 文 持 所 有 最 近 列 出 的 占 位 符 ， 如 application、profile 和 label。 开 发 人 员 可 以 使 用 
占 位 符 为 每 个 应 用 程序 创建 一 个 单独 的 存储 库 ， 如 https://github.conypiomin/{application}， 
甚至 可 以 为 每 个 配置 文件 创建 单独 的 存储 库 ， 如 https://github.com/piomin/{profile}。 这 种 
类 型 的 后 端 实现 可 以 将 HITP 资源 的 label 参数 映射 到 Git 标签 , 该 标签 可 以 引用 提交 ID、 
分 文 或 标记 名 称 等 。 同 样 ， 要 理解 这 些 有 趣 功能 的 最 合适 的 方法 就 是 通过 示例 ， 所 以 接 
下 来 我 们 将 创建 一 个 专门 用 于 存储 应 用 程序 属性 源 的 Git 存储 库 。 


人 


3. 构建 服务 器 应 用 程序 

笔者 已 经 创建 了 一 个 示例 配置 存储 库 ， 它 可 以 在 以 下 GitHub 地 址 找到 : 

https://github.com/piomin/sample-spring-cloud-config-repo.git. 

在 该 存储 库 中 放置 了 本 章 第 一 个 示例 所 使 用 的 所 有 属性 源 ， 其 中 说 明了 在 不 同 发 现 
区 域 中 运行 的 客户 端 应 用 程序 的 原生 配置 文件 文 持 。 现 在 ， 该 存储 库 保 存 了 此 列表 中 可 
见 的 文件 ， 如 图 5.3 所 示 。 


5 piomin / sample-spring-cloud-config-repo 你 Unwatchv 1 寅 star 1 | Yrork 0 


* COde IssUes 0 Pull regquests © Projects 到 Wiki ettings 


No description, website, or topics provided. 


Add topics 
Cn) 8 comimits v2 branches E> 0 releases Bg 1 contributor 
Braneh: master 一 New pull recuest Ereate newfile Upload files | Find file Clone or download = 


ee piomin Update client-service-zonel .yrml Latest coMmmit sb55658 on 20 Nowv 2017 
局 | .gitiqgnore adding master coniiguration 5 months ago 
全 | client-service-zone1l.yml Update cllent-service-zonel.y 5 months ago 
EE) client-service-zonea .yml adding master configuration 5 moniths ago 
上 EE] chent-service-zone3.yml adding master configuration 5 months agc 
EE discovery-service-zone1.yml adding master configuration 5 months age 


车 | discovery-senvice-zonez.ynil adding master oonlguratlon 5 months ago 


EE| discowvery-service-zone3.ym adding master configuration 5 months ago 


图 $3 GitHub 上 的 存储 库 示例 


Spring Cloud Config Server 默认 会 在 第 一 次 HTTP 资源 调用 后 尝试 克隆 存储 库 。 如 果 
要 在 启动 后 强制 克隆 它 ， 则 应 将 cloneOnStart 属性 设置 为 tue。 除 此 之 外 ， 还 需要 设置 存 
储 库 连接 设置 和 账户 身份 验证 凭据 。 


spring: 
application: 
name: config—-server 
cloud: 
config: 
SeTVeT : 
git: 
uri:https://github.com/piomin/sample-spring-cloud-config-—repo.git 
username: S${github.usernamel} 
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password: S${github.passwordl} 
cloneOnstart: 七 TU 


运行 该 服务 器 之 后 ， 我 们 可 以 调用 之 前 练习 中 己 知 的 端点 ， 如 http://localhost:8889/ 
client-service/zonel 或 http://localhost:8889/client-service-zone2.yml。 其 结果 与 前 面 的 测试 
结果 相同 ， 唯 一 的 区 别 在 于 数据 源 。 

现在 可 以 来 进行 男 一 项 练习 。 在 第 5.4 节 的 示例 中 ， 由 于 采用 了 发 现 优先 引导 方法 ， 
并 且 局 用 了 native 配置 文件 ， 所 以 该 示例 需要 对 客户 端的 属性 略 作 修 改 。 现 在 因为 使 用 
的 是 Git 后 端 ， 所 以 ， 可 以 针对 这 种 情况 开 肥 更 智能 的 解决 方案 。 在 当前 的 方法 中 ， 开 发 
人 员 应 该 在 GitHub 上 的 配置 库 中 创建 discovery 分 文 《https://github.conypiomin/sample- 
spring-cloud-config-repo/tree/discovery) ， 然 后 再 把 专用 于 该 应 用 程序 的 文件 放 上 去 (该 
应 用 程序 将 演示 发 现 优先 引导 机 制 )。 如 果 将 label 参 数 设置 为 discovery 然后 再 调用 Config 
Server 端点 ， 则 它 将 从 新 分 文中 获取 数据 。 开 发 人 员 可 以 答 试 分 别 调用 http://localhost:8889/ 
client-service/zonel/discovery 和 http:Wlocalhost:8889/discovery/client-service-Zzone2.yYml1， 然 
后 检查 和 对 比 其 结果 。 

现在 来 考虑 另 一 种 情况 。 假 设 已 经 更 改 了 client-service 第 三 个 实例 的 服务 器 端口 ， 
但 由 于 某 种 原因 , 想 要 回 到 之 前 的 值 。 那么 , 是 否 必 须 更 改 并 提交 client-service-zone3.yml 
才能 使 用 先前 的 端口 值 呢 ? 管 案 是 不 必 ， 现 在 开发 人 员 所 要 做 的 就 是 在 调用 HITP API 
资源 时 将 提交 ID 作为 label 参数 传递 。 已 经 执行 的 更 改 如 图 5.4 所 示 。 


5.4 通过 传递 label 参数 方式 修改 的 端口 


如 果 使 用 父 提交 ID 而 不 是 分 支 名称 调 用 API 端点 ， 则 将 返回 旧 端 口号 作为 响应 。 网 5.4 
是 调用 http://localhost:8889/e546dd6/client-service-zone3.yml 的 结果 ， 其 中 ，e546dd6 惑 是 
以 前 提交 的 了 D。 
eureka: 
client: 
ServiceUrl: 
defaultzone: http://localhost:8161/eurekal/ 
instance: 
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metadataMap: 
ZONeE: ZONe3 
Server: 
port: 8083 


4. 客户 端 配置 


在 使 用 Git 后 端 构建 服务 器 端 时 , 仅 演 示 了 HTTP 资源 调用 的 示例 。 以 下 是 客户 端 应 
用 程序 的 示例 配置 。 开 发 人 员 也 可 以 在 spring.profiles.active 运行 参数 中 传递 它 ， 而 不 是 
在 bootstrap.yml 中 设置 profile 属性 。 此 配置 将 使 客户 端 可 以 从 discovery 分 支 获取 属性 。 开 
发 人 员 也 可 以 决定 通过 在 label 属性 中 设置 它 来 切换 到 某 个 提交 ID， 这 在 前 面 已 经 介绍 过 。 
SpI1ing: 
application: 
name: client—service 
cloud: 
config: 
uri: http://localhost:8889 
profile: zonel 
label: discovery 


# label: e546dqd6 // 取 消 代 码 注 释 即 可 回 滚 
5. 多 个 存储 库 


开 友 人 员 有 时 可 能 需要 为 单 台 配置 服务 器 配置 多 个 存储 库 。 例 如 ， 可 以 想到 的 一 种 
情况 是 : 必须 将 业务 配置 与 典型 技术 配置 分 开 ， 这 绝对 是 有 可 能 的 。 


SPIInmG : 
cloud: 
config: 
SeTrVeT : 
i 
和 
httpPps://7github .comn/piomninyspring-cloud-config-repoyconftig-repo 
repos: 
simple: https://github.com/simple/config-repo 
special: 
pattern: special*/dev*,*special*/dev* 
uri: https://github.com/special/config—-repo 
local: 
pattern: lJocal* 


uri: file:/home/config/config-repo 
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5.53 Vault 后 站 


前 文 已 经 介绍 过 ，Vanult 是 一 种 工具 ， 它 可 以 通过 统一 的 接口 对 机 密 信 息 进 行 安全 访 
问 。 为 了 使 Config Server 能 够 使 用 该 类 型 的 后 端 ， 开 发 人 员 必 须 使 用 Vault 配置 文件 
--spring.profiles.active=vault 运行 它 。 当 然 ， 在 运行 Config Server 之 前 ， 还 需要 安装 并 局 
动 Vault 实例 。 建 议 开 发 人 员 使 用 Docker 来 完成 该 任务 。 由 于 这 是 本 书 第 一 次 介绍 与 
Docker 相关 的 内 容 ， 并 不 是 每 个 人 都 知道 该 工具 ， 在 本 书 第 14 章 “Docker 文 持 ”中 简 
要 介绍 了 Docker， 并 提供 了 它 的 基本 命令 和 用 例 ， 因 此 ， 如 果 这 是 你 第 一 次 接触 该 技术 ， 
则 不 妨 先 跳 到 第 14 章 翻 看 一 下 其 内 容 。 对 于 那些 熟悉 Docker 的 人 来 说 ， 则 应 该 很 容易 
理解 以 下 命令 示例 ， 它 将 在 开发 模式 下 运行 Vault 容器 。 开 及 人 员 可 以 使 用 VAULT 
DEV_LISTEN_ADDRESS 参数 履 盖 默认 的 侦 听 地 址 ， 或 者 使 用 VAULT DEV _ ROOT 
TOKEN ID 参数 履 兰 初始 生成 的 根 令 牌 的 D。 

docker run --cap-add=IPC LOCK -d --name=vault -e 

'VAULT DEV ROOT TOKEN ID=client' -p 8200:8200 vault 


1. Vault 入 门 

Vault 提供 了 一 个 命令 行 接口 ， 可 用 于 回 服务 器 添加 新 值 并 从 服务 喜 读 取 它 们 。 以 下 
显示 了 调用 这 些 命令 的 示例 。 但 是 ， 由 于 我 们 将 Vault 作为 Docker 容器 运行 ， 因 此 ， 管 
理 机 密 最 方便 的 方法 是 通过 HTTP API。 

$ vault write secret/hello value=world 

$ vault read secret/hello 

HTTP API 可 用 于 我 们 的 Vault 实例 (位 于 http://192.168.99.100:8200/vl/secret 地 址 
下 ) 。 调 用 该 API 的 每 个 方法 时 ， 需 要 将 令 牌 义 -Vault-Token 作为 请 求 头 传递 。 因 为 我 们 
在 启动 Docker 容器 时 已 经 在 VAULT DEV _ ROOT TOKEN ID 环境 参数 中 设置 了 该 值 ， 
所 以 它 等 于 client。 人 否则 ， 它 将 在 局 动 期 间 目 动 生成 ， 并 且 可 以 通过 调用 命令 docker logs 
vault 从 日 志 中 读 取 。 要 开始 使 用 Vault， 开 发 人 员 实际 上 需要 了 解 两 种 HTTP 方法 一 一 
POST 和 GET。 在 调用 POST 方法 时 ， 可 以 定义 应 该 添加 到 服务 器 的 机 密 列 表 。 在 以 下 
curl 命令 示例 中 ， 它 所 传递 的 参数 就 是 使 用 kv (key/value) 后 疹 创 建 的 ， 该 后 端的 作用 
类 似 于 键 / 值 (Key/Value) 存储 。 


$ curl -H "X-Vault-Token: client" -H "Content-Type: application/json" -X 
POST -d '{"server.port":8081,"sample.string.property": "Client 
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App","sample.int.property": 1}' 
http://192.168.99.100:8200/v1/secret/client-service 
可 以 使 用 GET 方法 从 服务 器 读 取 新 添加 的 值 。 


$ curl -H "X-Vault-Token: client"™ -X GET 
http://192.168.99.100:8200/v1/secret/client-service 


2. 与 Spring Cloud Config 集成 


正如 前 文 所 述 , 开发 人 员 必 须 使 用 --spring.profiles.active=vault 参数 运行 Spring Cloud 
Config Server， 这 样 才能 启用 Vault 作为 后 端 存 储 。 要 履 盖 默认 的 目 动 配置 设置 ， 应 该 在 
spring.cloud.config.server.vault.* 键 下 面 定义 属性 。 以 下 示例 显示 了 我 们 的 示例 应 用 程序 
的 当前 配置 。 在 GitHub 上 也 提供 了 这 样 一 个 示例 应 用 程序 ， 开 发 人 员 可 以 切换 到 
config vault 分 文 (https://github.com/piomin/sample-spring-cloud-netflix/tree/config vault) 
来 访问 它 。 
SPTInmG : 
application: 
name: config-—server 
cloud: 
coONnfig: 
SOLVEL: 
vault: 
nase | T0899 LO 
port: 8200 


现在 ， 开 发 人 员 可 以 调用 由 Config Server 公开 的 端点 。 虽 然 仍 必须 在 请 求 头 中 传递 
令 牌 ， 但 这 一 次 它 的 名 称 是 X-Config-Token。 


$ curl -X "GET" "http://localhost:8889/client-service/default" -H "X- 
Config-Token: client" 


其 啊 应 结果 应 该 如 下 所 示 。 这 些 属性 是 客户 端 应 用 程序 的 配置 文件 的 默认 属性 。 开 
发 人 员 还 可 以 添加 所 选 配置 文件 的 特定 设置 , 方法 是 在 逗号 字符 后 面 使 用 配置 文件 名 称 ， 
以 调用 Vault HTTP API 方法 ， 如 http://192.168.99.100:8200/vl/secret/client-service, zonel。 
如 果 调 用 路 径 中 包含 此 类 配置 文件 名 称 ， 则 啊 应 中 将 返回 default 和 zonel 配置 文件 的 

{ 


"name":"client-service”, 
“rotiles :| default |, 
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"label™ :noull, 
"version" :null, 
"state™ :null. 
"propertySources"™:|[{ 
"name"”:"vault:client-service”, 
"source™:1{ 
"sample.1nt.property" :1, 
"sample.string.property"”: "Client App', 
“Server. port :8081 


.| 
} 


3. 客户 端 配 置 


使 用 Vanult 作为 Config Server 的 后 新 时 ， 客 尸 端 需要 为 服务 器 传递 令 脾 ， 以 便 能 够 
从 Vault 检索 值 。 应 使 用 bootstrap.yml 文件 中 的 spring.cloud.config.token 属性 在 客户 端 配 
置 设置 中 提供 此 令 牌 
spring: 
application: 
name: client-—service 
cloud: 
config: 
uri: http://localhost:8889 
token: client 


5.6 其 他 功能 


现在 我 们 来 看 一 看 Spring Cloud Config 其 他 一 些 有 用 的 功能 。 
5.6.1 局 动 失败 和 重 试 


有 了 时， 如 果 Config Server 不 可 用 ， 则 启动 该 应 用 程序 没有 任何 意义 。 在 这 种 情况 下 ， 
开发 人 员 可 能 会 想 要 暂停 一 个 有 异常 的 客户 端 。 为 此 ， 必 须 将 引导 配置 属性 spring.cloud. 
config.failFast 设置 为 trme。 但 是 ， 这 种 比较 激进 的 解决 方案 有 时 候 并 不 是 开发 人 员 想 要 
的 。 如 果 仅 仅 是 偶尔 无 法 访问 配置 服务 器 ， 则 更 好 的 方法 是 继续 尝试 重新 连接 ， 直 到 成 
功 为 止 。spring.cloud.config.failFast 属性 仍然 必须 等 于 trme， 但 开发 人 员 还 需要 将 spring- 
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retry 库 和 spring-boot-starter-aop 添加 到 应 用 程序 类 路 径 中 。 默 认 行 为 将 假定 重 试 6 次 ， 
初始 退 避 (Backoff) 重 试 间 隅 为 1000 芭 秒 。 开 发 人 员 可 以 使 用 spring.cloud.config.retry.* 
配置 属性 履 盖 这 些 设置 。 


5.6.2 ”保护 客户 痛 的 安全 


与 服务 发 现 相 同 ， 开 发 人 员 可 以 使 用 基本 身份 验证 来 保护 配置 服务 器 。 使 用 Spring 
Security 可 以 在 服务 器 端 轻 松 局 用 它 。 在 这 种 情况 下 ， 客 户 端 仅 需 设置 bootstrap.yml 文件 
中 的 用 户 名 和 密 公 。 

SpIring: 

cloud: 
Contig: 
uri: https://localhost:8889 


username: user 
password: secret 


5.7 自动 重新 加 载 配置 


前 文 己 经 讨论 过 Spring Cloud Config 最 重要 的 功能 。 现 在 我 们 可 以 实现 一 个 示例 ， 
并 通过 它 来 演示 如 何 将 不 同 的 后 端 存储 用 作 存 储 库 。 但 是 ， 无 论 开 发 人 员 决 定 选择 的 是 
文件 系统 、Git 还 是 Vault， 客 户 端 应 用 程序 都 需要 重新 启动 才能 从 服务 右 端 获取 最 新 配 
置 。 当 然 ， 本 示例 有 时 候 并 不 是 最 佳 解决 方案 ， 特 别 是 如 果 有 许多 微服 务 运行 ， 并 且 其 
中 一 些 使 用 相同 的 通用 配置 的 话 ， 则 更 是 如 此 。 


5.7.1 解决 方案 架构 


即使 开发 人 员 已 经 为 每 一 个 应 用 程序 创建 了 一 个 专用 的 property 文件 ， 如 果 能 有 机 
会 动态 重新 加 载 它 而 不 必 重 局 ， 那 么 这 也 是 很 有 帮助 的 。 很 多 人 可 能 已 经 想到 了 ， 既 然 
Spring Boot 可 以 有 这 样 的 解决 方案 ， 那 么 对 于 Spring Cloud 来 说 上 日 然 也 是 适用 的 。 本 书 
第 4 章 “ 服 务 发 现 ” 在 解释 从 服务 发 现 服务 器 注销 时 ， 曾 经 引入 了 一 个 问 点 /shutdown， 
它 可 以 用 于 从 容 地 关闭 。 

还 有 一 个 可 用 于 Spring 环境 重启 的 端点 ， 其 工作 方式 与 /shutdown 类 似 。 

客户 疹 上 的 靖 点 只 是 一 个 大 得 多 的 系统 的 组 件 , 而 该 系统 需要 被 包含 才能 局 用 Spring 
Cloud Config 的 推送 通知 ,最 流行 的 源 代码 存储 库 提供 商 ( 如 GitHub、GitLab 和 Bitbucket ) 
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能 够 通过 提供 WebHook 机 制 发 送 有 关 存 储 库 中 更 改 的 通知 。 开 友 人 员 可 以 使 用 提供 商 的 
Web 仪表 板 将 WebHook 配置 为 URL 和 所 选 事件 类 型 的 列表 。 这 样 ， 提 供 商 束 可 以 使 用 
包含 提交 列表 的 正文 调用 WebHook 中 定义 的 POST 方法 。 在 项 目 中 需要 包含 Spring Cloud 
Bus 依赖 项 ， 以 便 在 Config Server 端 局 用 监控 端点 。 当 由 于 WebHook 激活 而 调用 此 端点 
时 ，Config Server 会 准备 并 发 送 一 个 事件 ， 其 中 包含 已 通过 最 近 一 次 提交 而 修改 的 属性 
源 列表 。 该 事件 将 被 发 送 给 消息 代理 。Spring Cloud Bus 为 RabbitMQ 和 Apache Kafka 提 
供 了 实现 。 对 于 RabbitMQ 来 说 ， 可 以 通过 包括 spring-cloud-starter-bus-amqp 依赖 项 来 启 
用 该 项 目 ; 而 对 于 Apache Kafka 来 说 ， 可 以 通过 包括 spring-cloud-starter-bus-kafka 依赖 
项 来 启用 。 此 外 ， 还 应 为 客户 端 应 用 程序 声明 这 些 依赖 项 ， 才 能 从 消息 代理 那里 接收 到 
消息 .开发 人 员 还 应 该 通过 使 用 @RefreshScope 注解 所 选 的 配置 类 来 启用 客户 端 上 的 动态 
刷新 机 制 。 此 解决 方案 的 架构 如 图 5.5 所 示 。 


 Git 存储 库 提 供 商 


客户 端 程序 


图 5.5 解决 方案 架构 
5.7.2 ”使 用 @RefreshScope 重新 加 载 配置 


这 次 异 第 将 从 客户 端 开 始 。 示 例 应 用 程序 可 在 GitHub (https://github.comvpiomin/ 
sample-spring-cloud-config-bus.git) 上 获得 。 与 前 面 的 示例 相同 ， 它 使 用 了 Git 存储 库 作 
为 后 靖 存 储 ， 这 也 可 以 在 GitHub (https:Wgithub.comy/piomin/sample-spring-cloud-config- 
repo) 上 创建 。 此 外 ， 我 们 还 回 客 户 端 的 配置 文件 添加 了 一 些 新 属性 ， 并 将 更 改 提 交 到 存 
储 库 。 以 下 是 客户 端 配置 的 当前 版 本 。 


eureka: 
instance: 
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metadataMap: 
7ONe: ZONnel 
client: 
全 正人 EECEUET 
defaultzone: http://l]ocalhost:8761/eurekal 
Server: 
port: S${PORT:808]1] 
management: 
SECuUrity: 
enabled: false 
sample: 
string: 
property: Client App 
int: 
PPODETEtYS 注 


* 10l1* 


开发 人 员 可 以 通过 将 management.security.enabled 设置 为 false 来 禁用 Spring Boot 


QComponent 

QRefreshScope 

public class ClientConfiguration 1{ 
QValue ("${sample.string.property}") 
private String sampleStringProperty; 
QVvalue ("$s{sample.int.property}") 
private int samplelIntProperty; 


Public String showProperties() 1 


return String.format ("Hello from $s $%d", sampleSsStringProperty, 


samplelIntProperty); 
} 


Actuator 端点 的 安全 性 , 这 是 在 不 传递 安全 凭证 的 情况 下 调用 这 些 端点 所 必需 的 。 此 外 还 
需要 添加 sample.string.property 和 sample.int.property 两 个 测试 参数 , 以 根据 示例 中 的 值 来 
演示 bean 刷新 机 制 。Spring Cloud 为 Spring Boot Actuator 提供 了 一 些 额 儿 
疹 点 。 其 中 一 个 是 /refrfesh， 它 负责 重新 加 载 Bootstrap 上 下 文 和 使 用 @RefreshScope 注解 
的 刷新 bean。 这 是 一 个 HITP POST 方法 ,可 以 在 客户 端 实例 Chttp:Wlocalhost:8081refresh ) 
上 调用 ,在 测试 该 功能 之 前 ,开发 人 员 需 要 运行 发 现 和 配置 服务 器 。 应 使 用 --spring.profiles. 
active=zonel 参数 启动 客户 端 应 用 程序 。 在 以 下 类 中 ， 可 以 将 测试 属性 sample.string. 
property 和 sample.int.property 注入 字段 中 。 


` 和 的 HTTP 管理 
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该 bean 被 注入 ClientController 类 并 在 ping 方法 中 调用 ， 访 方法 在 http://localhost: 
8081/ping 位 置 处 公开 。 


QRestController 
Pablic class ClientController 1 


QAutowired 
private ClientConfiguration conf; 


RQGetMapping ("/ping") 
public String ping() { 
return conf.showProperties()}:; 


: 

] 

现在 ， 开 发 人 员 可 以 改变 client-service-zonel.yml 中 测试 属性 的 值 并 提交 和 它们。 如果 
调用 Config Server HTTP 端点 /client-service/zone1， 则 将 看 到 作为 啊 应 返回 的 最 新 值 。 但 
是 ， 当 调用 客户 端 应 用 程序 上 公开 的 /ping 方法 时 ， 开 发 人 员 仍 会 在 如 网 5.6 所 示 的 屏幕 
截图 的 左 侧 看 到 较 旧 的 值 。 为 什么 ?其 实 这 也 很 好 理解 ， 虽 然 Config Server 会 自动 检测 
存储 库 更 改 ， 但 是 客户 问 应 用 程序 无 法 在 没有 任何 触发 右 的 情况 下 上 自动 刷新 。 它 需要 重 
新 启动 才能 读 取 最 新 设置 ， 或 者 开发 人 员 也 可 以 通过 调用 之 前 所 描述 的 /refresh 方法 来 强 
制 重 新 加 载 配置 。 


5.6 ”在 没有 任何 触发 器 的 情况 下 客户 端 应 用 程序 不 会 目 动 刷 新 


在 客户 端 应 用 程序 上 调用 /refresh 端点 后 ， 开 发 人 员 将 在 日 志文 件 中 看 到 已 经 重新 加 
载 配置 。 现 在 ， 如 果 再 次 调用 ping， 则 会 在 啊 应 中 返回 最 新 的 属性 值 ， 如 图 5.7 所 示 。 该 
示例 说 明了 热 重 载 如 何 适 用 于 Spring Cloud 应 用 程序 ， 但 它 显然 不 是 我 们 的 目标 解决 方 
案 。 我 们 的 下 一 步 是 启用 与 消息 代理 的 通信 。 
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B localhost:8081/ping 


< G 人 © localhost8081/ping 


Hello from Client Application 2 


图 5.7 调用 /ping 之 后 的 响应 结果 
5.7.3 ”使 用 来 自 消息 代理 的 事件 


前 文 已 经 提 到 过 ， 开 发 人 员 可 以 选择 两 个 与 Spring Cloud Bus 集成 的 消息 代理 
(Message Broker) 。 在 本 示例 中 ， 将 演示 如 何 运行 和 使 用 RabbitMQ。 关 于 这 个 解决 方 
案 有 必要 多 做 一 些 介绍 ， 因 为 这 是 在 本 书 中 第 一 次 处 理 它 。RabbitMQ 己 经 太 展 成 为 最 受 
欢迎 的 消息 代理 软件 。 它 是 用 Erlang 编写 的 ， 并 且 实 现 了 高 级 消息 队列 协议 (Advanced 
Message Queueing Protocol，AMQP) 。 它 易于 使 用 和 配置 ， 即 使 对 于 我 们 正在 讨论 的 集 
群 或 高 可 用 性 等 机 制 来 说 也 不 例外 。 

要 在 开发 人 员 的 机 器 上 运行 RabbitMQ， 最 简便 的 方法 是 通过 Docker 容器 。 该 容器 
己 经 公开 了 两 个 端口 。 第 一 个 端口 用 于 客户 端 连 接 ($672) ， 第 二 个 端口 用 于 管理 仪表 
板 (15672) 。 此 外 ， 我 们 还 使 用 了 management 标记 来 运行 镜像 (Image) ， 以 启用 用 户 
界面 仪表 板 ， 这 在 默认 版 本 中 是 不 可 用 的 。 


docker run -d --name rabbit -P5672:5672 -p 15672:15672 rabbitmgq:management 


要 为 我 们 的 示例 客户 端 应 用 程序 启用 对 于 RabbitMQ 代理 的 支持 ， 应 该 在 pom.xml 
中 包含 以 下 依赖 项 。 
<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-bus-amgqp</artifactId> 
</dependency> 


该 库 包 含 自动 配置 设置 。 因 为 我 们 是 在 Windows 系统 上 运行 Docker， 所 以 需要 覆盖 
一 些 默认 属性 。 完 整 的 服务 配置 存储 在 Git 存储 库 中 ， 因 而 更 改 仅 影 啊 远 程 文件 。 开发 人 
员 应 该 将 以 下 参数 添加 到 以 前 使 用 的 客户 端 属性 源 版 本 中 。 
SpIring: 
rabbitmad: 


host: 192.168.99.100 
port: Ss612 
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Username: guest 
password: quest 
此 时 如 果 运 行 该 客户 端 应 用 程序 , 则 将 在 RabbitMQ 中 上 自动 创建 交换 消 轧 和 队列 。 开 

发 人 员 可 以 登录 http://192.168.99.100:15672 上 的 管理 仪表 板 轻 松 查看 。 默 认 用 户 名 和 密 
码 是 guest/guest。 如 图 5.8 所 示 是 笔者 的 RabbitMQ 实例 的 屏幕 截图 ， 可 以 看 到 已 经 创建 
了 一 个 名 为 springCloudBnus 的 交换 消息 (Exchange) ， 有 两 个 绑 定 到 客户 疹 队 列 和 Config 
Server 队列 (笔者 已 经 使 用 更 改 运行 它 ， 详 见 第 5.7.4 节 中 的 说 明 ) 。 在 目前 这 个 阶段 ， 
开发 人 员 还 不 必 着 总 深入 了 解 RabbitMQ 及 其 架构 ,在 本 书 第 11 章 “ 消 息 驱 动 的 微服 务 ” 
有 大 Spring Cloud Stream 项 目的 讨论 中 将 会 对 此 做 更 详细 的 说 明 。 


© ff 192.168.99.100:15672/#/exchanges/%2F/springCloudBus 


中 Nabblt se 


Overview Connections Channels Exchanges QueUes Admin 


Exchange: springCloudBus 


” Overview 


Maessage rates lat minute ? 
Currentiy idle 
Detalls 

Type | topic 


Features | durable: trua 
Policy 
Bindings 
This exchange 


J 


To Routing key Arguments 


springCloudBus.anonymous.DvyUbhzySsSmaTrDe]LAz2w i 
springCloudBus.anonymous.Hv WIaCHv Ot-6wITyVezrNw 


图 5.8 ”RabbitMQ 实例 的 屏幕 截图 
5.7.4 监视 Config Server 上 的 存储 库 更 改 


Spring Cloud Config Server 必须 在 前 面 描述 的 过 程 中 执行 两 项 任务 。 首 先 ， 它 必须 检 
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测 存储 在 Git 存储 库 中 的 property 文件 中 的 更 改 。 这 可 以 通过 公开 特殊 端点 来 实现 , 该 端 
点 将 由 存储 库 提 供 商 通过 WebHook 调用 。 第 二 个 步 又 是 准备 并 发 送 一 个 针对 可 能 已 更 改 
的 应 用 程序 的 RefreshRemoteApplicationEvent 事件 , 这 反 过 来 义 要 求 开 发 人 员 与 消 晨 代理 
建立 连接 。spring-cloud-config-monitor 库 人 负责 启用 /monitor 端点 。 要 启用 对 RabbitMQ 代 
理 的 支持 ， 应 该 包含 与 客户 端 应 用 程序 相同 的 局 动工 件 。 


<dependency> 
<gqroupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-config-monitor</artifactId> 

</dependency> 

<dependency> 
<grouplId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-starter-bus-amqp</artifactId> 

</dependency> 


这 还 不 是 全 部 。 开 发 人 员 还 应 在 application.yml 中 激活 配置 监控 程序 (Monitor) 。 
由 于 每 个 存储 库 提供 商都 在 Spring Cloud 中 具有 专用 实现 ， 因 而 有 必要 选择 应 该 局 用 哪 
一 个 存储 库 提供 商 。 


SpI1ing: 
application: 
name: Config—server 
cloud: 
config: 
SETPTVerP: 
monitor: 
github: 
enabled: true 
升 友 人员 可 以 目 定 义 更 改 检 测 机 制 。 默认 情况 下 ， 它 会 检测 与 应 用 程序 名 称 匹 配 的 
文件 中 的 更 改 。 要 和 窗 产 该 行为 , 需要 提供 PropertyPathNotificationExtractor 的 和 目 定义 实现 。 
它 接 党 请 求 头 和 正文 参数 , 并 返回 已 更 改 的 文件 路 径 列 表 。 为 了 文 持 来 自 GitHub 的 通知 ， 
可 以 使 用 spring-cloud-config-monitor 提供 的 GithubPropertyPathNotificationExtractor。 
@Bean 
public GithubPropertyPathNotifticatijonExtractor 
githubPropertyPathNotificatijonExtractor() 1 


return new GithubpropertyPathNotificationExtractor(); 


} 


1.， 手动 模拟 更 改 事件 
monitor 端点 可 以 由 Git 存储 库 提 供 了 两 (如 GitHub、Bitbucket 或 GitLab) 上 配置 的 
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WebHook 调用 。 使 用 在 localhost 上 运行 的 应 用 程序 测试 此 类 功能 很 及 烦 。 事 实证 明 ， 开 
发 人 员 可 以 通过 手动 调用 POST /monitor 来 轻松 模拟 这 样 的 WebHook 激活 。 例如 , Github 
命令 应 该 在 请 求 中 包含 标 头 X-Github-Event。 有 具有 property 文件 更 改 的 JSON 正文 应 该 如 
以 下 cURL 请 求 中 所 示 。 

$ curl -H "X-Github-Event: push" -H "Content-Type: application/json" -X 

POST -d '{"commits": [{"modified": ["client-service-zonel .yml"]}]}' 

http://localhost:8889/monitor 

现在 ， 可 以 在 client-service-zonel.yml 文件 中 更 改 并 提交 一 个 属性 的 值 ， 例 如 ， 修 改 
属性 sample.int.property。 人 然后 ， 可 以 使 用 前 面 示例 命令 中 显示 的 参数 调用 POST /monitor 
方法 。 如 果 根 据 上 面 的 说 明 配 置 了 所 有 内 容 ， 则 应 在 客户 端 应 用 程序 端 看 到 以 下 日 志 行 : 
Received remote refresh request. Keys refreshed [sample.int.property] (已 接收 到 远程 刷新 请 
求 。 刍 值 己 刷 新 [sample.int.property])。 如 果 调 用 客户 病 微 服务 公开 的 /ping 端点 ， 那 么 它 
应 该 返回 己 更 改 属 性 的 最 新 值 。 

2. 使 用 GitLab 实例 在 本 地 进行 测试 

对 于 那些 不 喜欢 模拟 事件 的 开发 人 员 ， 我 们 提出 了 一 个 更 实际 的 练习 。 但 是 ， 需 要 
指出 的 是 ， 它 不 仅 需 要 开发 技能 ， 还 需要 掌握 持续 集成 (Continuous Integration) 工具 的 
基本 知识 。 我 们 将 首先 使 用 GitLab 的 Docker 镜像 在 本 地 运行 GitLab 实例 。GitLab 是 一 
个 开源 的 基于 Web 的 Git 存储 库 管理 器 ， 上 有 具有 维基 百科 和 问题 跟踪 的 特点 。 它 与 GitHub 
或 Bitbucket 等 工具 非常 相似 ， 但 可 以 轻松 部 署 在 本 地 计算 机 上 。 

docker run -d --name gitlab -p 10443:443 -P 10080:80 -p 10022:22 

gitlab/gitlab-ce:latest 

Web 仪表 板 可 在 http://192.168.99.100:10080 获得 。 第 一 步 是 创建 管理 员 用 户 ， 然 
后 使 用 提供 的 凭据 登录 。 对 于 GitLab 其 实 不 必 做 过 多 介绍 , 它 具 有 用 户 友 好 且 直 观 的 
GUI 界面 ， 因 而 开发 人 员 肯 定 能 够 轻松 使 用 它 。 现 在 继续 进行 下 一 步 操 作 ， 我 们 已 经 
在 GitLab 中 创建 了 一 个 名 为 sample-spring-cloud-config-repo 的 项 目 ， 开 发 人 员 可 以 从 
http://192.168.99.100:10080/root/sample-spring-cloud-config-repo.git 克隆 它 。 我 们 在 该 位 置 
提交 了 相同 的 配置 文件 集 ， 可 以 在 GitHub 上 的 示例 存储 库 中 找到 。 下 一 步 是 定义 一 个 
WebHook， 它 将 通过 推送 通知 调用 Config Server 的 /monitor 端点 。 要 为 项 目 添 加 新 的 
WebHook， 需 要 转 到 Settings | Integration (设置 | 集成 ) 部分， 然后 用 服务 器 地 址 填写 
URL 字段 (注意 ， 是 使 用 主机 名 而 不 是 localhost) ， 然 后 保持 选中 Push events (推送 事 
件 ) 复 选 框 ， 如 图 5.9 所 示 。 
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Administrator 》 sample-spring-cloud-,. » Ilntegrations Settings 


Integrations URL 


Webhooks can be used for binding events when http://piomin:8889/monito| 
something is happening within the project. 


Secret Token 


Use this token to valdate receved payloads, lt will be sent with the request Im the MX-Gitlab- Token 
HTTP header 


Trigger 
[|Push events 
This URL will be triggered by a push to the repository 


5.9 添加 新 的 WebHook 


与 使 用 GitHub 作为 后 端 存储 库 提 供 商 的 Config Server 实现 相 比 ， 我 们 需要 在 
application.yml 中 更 改 已 启用 的 monitor 类 型 。 当 然 ， 还 需要 提供 不 同 的 地 址 。 


SPpI1ing: 
application: 
name: config—server 
cloud: 
config: 
二 的 放 研 E 国 
monitor: 
gitlab: 
enabled: true 
可 二 二 
url: 
http://192.168.99.100:10080/root/sample-spring-cloud-config-repo.git 
Username: Ioot 
password: rootl123 
cloneOnSstart: true 


还 应 该 注册 另 一 个 bean 以 实现 PropertyPathNotificationExtractor。 


Bean 
public GitlabPpropertyPathNotificationExtractor 
gitlabPropertyPathNotificatijonExtractor() 1 

return new GitlabpropertyPathNotificationExtractor()}); 


} 


最 后 ， 开 发 人 员 可 以 在 配置 文件 中 进行 一 些 更 改 ， 此 时 WebHook 应 该 被 激活 ， 并 刷 
新 客户 端 应 用 程序 的 配置 。 
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5.8 小 结 


本 章 详细 介绍 了 Spring Cloud Config 项 目的 最 重要 功能 。 与 “服务 发 现 ” 的 介绍 方 
式 相 同 ， 本 章 从 最 基础 的 并 且 很 简单 的 客户 端 和 服务 器 端 用 例 开 始 ， 详 细 讨 论 了 Config 
Server 的 不 同 后 端 存储 库 类 型 ， 并 且 通 过 实现 示例 的 方式 说 明了 如 何 使 用 文件 系统 、Git 
甚至 第 三 方 工 具 (如 Vault) 作为 property 文件 的 存储 库 。 本 章 还 特别 关注 与 其 他 组 件 ( 如 
服务 发 现 或 大 型 系统 中 的 多 个 微服 务实 例 ) 的 互 操 作 性 。 最 后 ， 本 章 演示 了 如 何在 不 重 
启 的 情况 下 重新 加 载 应 用 程序 的 配置 ， 这 是 基于 WebHooks 和 消息 代理 实现 的 。 总 之 ， 
在 阅读 本 章 之 后 ， 开 发 人 员 应 该 能 够 将 Spring Cloud Config 用 作 基 于 微服 务 架构 的 一 个 
元 素 ， 并 充分 利用 其 主要 功能 。 

在 掌握 了 使 用 Spring Cloud 实现 “服务 发 现 ” 和 “配置 服务 器 ”功能 之 后 ， 即 可 进 
行 对 服务 间 通 信 机 制 的 讨论 。 在 接 下 来 的 两 章 中 ， 我 们 将 分 析 与 其 相关 的 基本 示例 和 一 
些 更 高 级 的 应 用 ， 这 些 示例 将 演示 知 干 个 微服 务 之 间 的 同步 通信 。 


第 6 章 ， 微 服务 之 间 的 通信 


在 前 两 章 中 ， 我 们 讨论 了 与 微服 务 架 构 一 一 服务 发 现 和 配置 服务 器 中 非常 重要 的 元 
素 相 关 的 细节 。 但 是 ， 值 得 一 提 的 是 ， 它 们 在 系统 中 存在 主要 是 为 了 帮助 管理 独立 应 用 
程序 的 整体 设置 。 该 管理 的 一 个 方面 就 是 微服 务 之 间 的 通信 。 在 这 里 ， 服 务 发 现 扮演 了 
一 个 特别 重要 的 角色 ， 它 负责 存储 所 有 可 用 应 用 程序 的 网 络 位 置 并 提供 服务 。 当 然 ， 我 
们 也 可 以 设想 一 个 没有 服务 发 现 服 务 器 的 系统 架构 ， 本 章 就 将 介绍 这 样 的 示例 。 

当然 ， 参 与 服务 间 通 信和 的 最 重要 组 件 是 HTTP 客户 端 和 客户 端 负载 均衡 器 。 本 章 将 
重点 关注 它们 。 

本 章 将 要 讨论 的 主题 包括 : 

口 使 用 Spring RestTemplate 进行 有 和 没有 服务 发 现 的 服务 间 通 信 。 

口 上 日 定义 Ribbon 客户 并 。 

口 Feign 客户 问 提 供 的 主要 功能 的 描述 ， 如 与 Ribbon 客户 端的 集成 、 服 务 发 现 、 

继承 和 分 区 文 持 。 


6.1 不 同类 型 的 通信 


微服 务 之 间 的 通信 具有 不 同 的 类 型 。 可 以 从 两 个 维度 来 划分 它们 。 第 一 个 维度 是 将 
其 划分 为 同步 〈Synchronous ) 和 异步 (Asynchronous) 通信 协议 。 异 步 通信 的 关键 要 点 
是 客户 端 在 等 待 啊 应 时 不 应 该 阻塞 线程 。 这 种 通信 最 流行 的 协议 是 AMQP， 在 第 $ 章 的 
末尾 我 们 已 经 介绍 了 使 用 该 协议 的 示例 。 

当然 ， 服 务 之 间 的 主要 通信 方式 仍然 是 同步 HTTP 协议 ， 本 章 将 对 其 进行 详细 讨论 。 

第 二 个 维度 是 按照 存在 单个 消息 接收 器 还 是 多 个 消息 接收 器 来 划分 的 ， 可 以 划分 为 
“一 对 一 ”或 “一 对 多 ”通信 类 型 。 在 “一 对 一 ”通信 中 ， 每 个 请 求 仅 由 一 个 服务 实例 
处 理 ; 在 “一 对 多 ”通信 中 ,每 个 请 求 可 以 由 许多 不 同 的 服务 处 理 。 本 书 将 在 第 11 章 “ 消 
轧 驱 动 的 微服 务 ” 中 对 此 展开 详细 的 讨论 。 


而 


6.2 使 用 Spring Cloud 进行 同步 通信 


Spring Cloud 提供 了 一 组 组 件 来 帮助 开发 人 员 实 现 微 服务 之 间 的 通信 。 第 一 个 组 件 是 


。110 。 精通 Spring Cloud 微服 务 架 构 


RestTemplate， 它 总 是 用 于 在 客户 端 使 用 RESTful Web 服务 ， 包含 在 Spring Web 项 目 中 。 
要 在 微服 务 环境 中 有 效 地 使 用 它 ， 应 该 使 用 @LoadBalanced 限定 符 (Qualifier) 进行 注解 。 
由 此 它 将 自动 配置 为 使 用 Netflix Ribbon, 它 将 能 够 通过 使 用 服务 名 称 而 不 是 IP 地 址 来 利 
用 服务 发 现 。 Ribbon 是 一 个 客户 端 负载 均衡 器 , 它 提 供 了 一 个 简单 的 接口 , 允许 控制 HITP 
和 TCP 客户 端的 行为 。 它 可 以 轻松 地 与 其 他 Spring Cloud 组 件 集 成 ， 如 服务 发 现 或 断路 
器 。 此 外 ， 它 对 开发 人 员 完 全 透明 。 第 二 个 可 用 组 件 是 Feign， 这 是 一 个 同样 来 和 目 Netflix 
OSS 的 声明 性 REST 客户 端 。Feign 已 经 使 用 Ribbon 进行 负载 均衡 ， 并 且 可 以 从 服务 发 
现 中 获取 数据 。 可 以 通过 使 用 @FeignClient 注解 方法 在 界面 上 轻松 声明 它 。 本 章 将 详细 
介绍 此 处 列 出 的 所 有 组 件 。 


6.3 使 用 Ribbon 执行 负载 均衡 


与 Ribbon 有 关 的 主要 概念 是 命名 客户 端 〈《Client) 。 这 就 是 为 什么 开发 人 员 可 以 使 
用 客户 端的 名 称 而 不 是 带 有 主机 名 和 端口 的 完整 地 址 来 调用 其 他 服务 ， 并 且 无 须 连 接 到 
服务 发 现 。 在 这 种 情况 下 ， 应 该 在 application.yml 文件 内 的 Ribbon 配置 设置 中 提供 地 址 
的 列表 。 


6.3.1 使 用 Ribbon 客户 端 启用 微服 务 之 则 的 通信 


现在 来 继续 这 个 示例 。 它 由 4 个 独立 的 微服 务 组 成 ， 其 中 一 些 可 能 会 调用 其 他 微服 
务 公 开 的 端点 。 应 用 程序 源 代 码 可 在 以 下 地 址 处 获得 。 


https://github.com/piomin/sample-spring-cloud-comm.git 


在 这 个 示例 中 ， 我 们 将 答 试 开发 一 个 简单 的 订单 系统 ， 客 户 可 以 在 该 系统 中 购买 产 
品 。 如 果 客 户 决 定 确认 要 购买 的 所 选 产品 列表 ， 则 POST 请 求 将 发 送 到 order-service〈 订 
单 服务 ) 。 它 由 REST 控制 右 内 的 Order prepare(@RequestBody Order order){...} 方 法 处 理 。 
该 方法 负责 订单 的 准备 。 首 先 ， 它 将 从 order-service 中 调用 适当 的 API 方法 ， 考 虑 产品 
列表 中 每 个 产品 的 价格 、 客 户 订 购 的 历史 记录 及 客户 在 系统 中 的 类 别 等 因素 ， 计 算出 最 
终 价 格 ; 然后 ， 它 通过 调用 accountrservice〈 账 户 服务 ) ， 验 证 客户 的 账户 余额 是 否 足 够 
执行 订单 ;， 最后， 它 返 回 计 算 的 价格 。 如 果 客 户 确 认 操 作 ， 则 调用 PUT /fid} 方 法 。 该 请 
求 将 由 REST 控制 器 内 的 Order accept((@PathVariable Long id){...} 方 法 处 理 。 它 会 更 改 订 
单 的 状态 并 从 客户 的 账户 中 提取 资金 。 该 系统 架构 可 以 分 解 为 各 个 微服 务 , 如 图 6.1 所 示 。 
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图 6.1 微服 务 之 间 通 信 示 例 的 系统 架构 
6.3.2 静态 负载 均衡 配置 


本 示例 中 的 order-service (订单 服 务 ) 必须 与 该 示例 中 的 所 有 其 他 微服 务 进行 通信 ， 
以 执行 所 需 的 操作 ， 因 此 ， 开 发 人 员 需 要 使 用 ribbon.listOfServers 属性 定义 3 个 不 同 的 
Ribbon 客户 端 ， 并 且 这 些 客 户 端 需要 包含 网 络 地 址 设置 。 该 示例 中 的 第 二 个 重要 事项 是 
在 Eureka 中 禁用 默认 启用 的 发 现 服务 。 以 下 是 application.yml 文件 中 order-service 的 所 
有 已 定义 属性 。 
port: 8090 


account—service: 
ribbon: 
eureka: 
enabled: false 
listofServers: localhost:8091 
CUStomer—SsService: 
ribbon: 
eureka: 
enabled: false 
115tO0OfServers: Jocalhost:8092 
PIOdUcCt— service: 
ribbon: 
euUureka: 
enabled: false 
listofServers: localhost:8093 


开发 人 员 还 应 该 在 项 目 中 包含 以 下 依赖 项 ， 以 便 将 RestTemplate 与 Ribbon 客户 端 结 
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合 在 一 起 使 用 。 


<dependency> 
<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-ribbon</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 


然后 ， 开 发 人 员 可 以 通过 声明 application.yml 中 配置 的 名 称 列 表 来 启用 Ribbon 客户 
端 。 为 完成 此 操作 ， 可 以 使 用 @RibbonClients 注解 main 类 或 任何 其 他 Spring 配置 类 。 开 
发 人 员 还 应 该 注册 RestTemplate bean 并 使 用 @LoadBalanced 注解 它 ， 以 启用 与 Spring 
Cloud 组 件 的 交互 。 


aspringBoctapp1ication 

aRibboncCc1lients(1{ 

QRibbonclient (name = "account 一 SerVice "1) ， 
QRibbonClient (name 
QRibbonClient (name = "product-—-service") 
}) 

public class OrderApplication 1 


"customer-service™), 


QLoadBalanced 

Bean 

RestTemplate restTemplatel() 1 
return new RestTemplate (})} 


Public static void main (Stringl|] args} | 
New 
SpringApplicationBuilder (OrderApplication.class) .web (true) .run(largs)}); 
} 
/ 
} 


6.3.3 ”调用 其 他 服务 


最 后 ， 我 们 可 以 开始 实现 OrderController (订单 控制 程序 ) ， 它 负责 提供 公开 到 微服 


第 6 章 微服 务 之 间 的 通信 。113。 


务 之 外 的 HTTP 方法 。 它 注入 了 RestTemplate bean 以 便 能 够 调用 其 他 HTTP 端点 。 开 发 
人 员 可 能 会 在 以 下 源 代 码 片 段 中 看 到 使 用 application.yml 中 配置 的 Ribbon 客户 端 名 称 而 
不 是 卫 地 址 或 主机 名 。 使 用 相同 的 RestTemplate bean， 即 可 与 3 个 不 同 的 微服 务 进 行 通 
信 。 在 这 里 需要 花 一 点 时 间 来 讨论 控制 程序 内 部 可 用 的 方法 。 在 第 一 个 实现 的 方法 中 ， 
可 以 调用 product-service 〈 产 品 服务 ) 的 GET 应 点 ， 该 端点 将 返回 包含 所 选 产品 详细 信 
轧 的 列表 。 然 后 ， 可 以 调用 customer-service (客户 服务 ) 公开 的 GET /withAccounts/ {id} 
方法 ， 它 将 返回 客户 详细 信息 及 其 账户 列表 。 

现在 ， 开 发 人 员 拥 有 了 计算 最 终 订 单价 格 所 需 的 所 有 信息 ， 并 将 验证 客户 在 其 主 账 
户 中 是 否 有 足够 的 资金 。PUT 方法 将 调用 account-service【〈 账 户 服务 ) 的 端点 以 从 客户 账 
户 中 提取 资金 。 昌 然 我 们 花 了 很 多 时 间 来 讨论 OrderController 中 可 用 的 方法 ， 但 我 们 认 
为 这 是 必要 的 ， 因 为 相同 的 示例 将 用 于 显示 Spring Cloud 组 件 的 主要 功能 ， 这 些 组 件 提 
供 了 微服 务 之 间 同 步 通 信 的 机 制 。 


QRestController 
PubDIicC class OrderController 1 


QAutowired 

OrderRepository repository; 
QAutowired 

RestTemplate template; 


QPostMapping 
public Order prepare (RequestBody Order order) I 
int price = 0; 


Product|[||] products = 
template.postForoObject ("http://product-service/ids"™, 
order.geteEroductlids(},. Prodnctl|l.. classys 
CLUStomer customer = 
template.getForobject ("http://customer—-service/withAccounts/{iqd}", 
Customer.class, order.getCustomerld()}; 
for (Product product : products) 
price 1+= product .getPricet}; 
final int priceDiscounted = priceDiscount (price, customer);}; 
Optional<Account> account = customer.getAccounts () .stream() .filter (a—> 
(a.getBalance(} > priceDiscounted}))}) .findFirst()}); 
jf (account.lisPpresent (}) I 
order.setAccountIld(account .Get () .get1Id()); 
order.setSstatus (Orderstatus .ACCEPTED); 
order.setPrice (priceDiscounted); 
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} else | 

order.setSstatus (Orderstatus .REJECTED); 
} 
return repository.add (order)}); 


} 


QPutMapping ("/{id}") 

public Order accept (GPathVvariable Long id) 1 
final Order order = repository.findBylIdl(id).; 
template.put ("http://account-service/withdraw/{id}/{amount}", null, 

order.getAccountIid(}, order.getPricel())}); 
order.setSstatus (Orderstatus .DONE) ; 
repository.update (order);} 
return orders 

} 

je 

| 


这 里 比较 有 趣 并 值得 注意 的 是 ，customer-service 的 GET /withAccounts/{id} 方 法 (由 
order-service 调用 ) 也 使 用 Ribbon 客户 端 与 男 一 个 微服 务 account-service 进行 通信 。 以 下 
是 来 日 CustomerController 的 片段 ， 它 具有 上 述 方法 的 实现 。 

QQGetMapping ("/withAccounts/{id}") 

public Customer findByIdWithAccounts (@PathVvariable ("id") Long id) 1 

Account|[| accounts = 

template.getForobject ("http://account-service/customer/{customerId}™", 
Account|[|.class, id}); 

Customer C = repository.findBylIdl(id),; 

Cc.SetAccounts (Arrays.streaml(laccounts)}) .collect (Collectors.toList()}).; 
TeEDPT C3 

} 

要 测试 该 示例 ， 可 以 按 以 下 步 桑 操作。 首先， 使 用 Maven 命令 mvn clean install 构建 
整个 项 目 。 然 后 ， 使 用 java -jar 命令 以 任意 顺序 启动 所 有 微服 务 ， 而 无 须 任何 其 他 参数 。 
当然 ， 开 发 人 员 也 可 以 从 集成 开发 环境 中 运行 该 应 用 程序 。 在 启动 时 应 该 为 每 个 微服 务 
准备 测试 数据 。 由 于 没有 持久 性 存储 ， 因 而 重启 后 将 删除 所 有 对 象 。 开 发 人 员 可 以 通过 
调用 order-service 公开 的 POST 方法 来 测试 整个 系统 。 示 例 请 求 如 下 所 示 。 

$ curl -d '{"productIds": [1,5],"customerId": 1,"status": "NEW"}' -H 

"Content-Type: application/json" -X POST http://localhost:8090 


如 果 尝 试 发 送 此 请 求 ， 开 发 人 员 将 能 够 看 到 Ribbon 客户 端 打 印 的 以 下 日 志 。 
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DynamicServerListLoadBalancer for client customer-service linitialized: 
DynamicServerListLoadBalancer: {NFLoadBalancer:name=customer-service, 
current lJ]ist of Servers=[localhost:8092] ,Load balancer stats=Z2one 
stats: {unknown=[Zone:unknown; Instance count:1; Actijve connections 
count: 0;Circuit breaker tripped count: 0; Active connections per 
server: 0.0;]},Server stats: [[Server:localhost:8092; Zone:UNKNOWN: 
Total Requests:0; Successive connection failure:0; Total blackout 
seconds:0; Last connection made:Thu Jan 01 01:00:00 CET 1970; First 
connection made: Thu Jan 01 01:00:00 CET 1970; Active Connections:0.， 
total failure count in last (1000) msecs:0 average resp time:0.0,， 
90 percentile resp time:0.0; 95 percentile resp tijme:0.0; min resp 
time:0.0; max resp time:0.0; stddev resp time:0.0] ]} ServerList: 


com.netflix.l]oadbalancer. ConfigurationBasedServerList@7fle23f6 


需要 指出 的 是 ， 本 节 描 述 的 方法 有 一 个 很 大 的 人 缺点， 这 使 得 它 在 由 知 干 个 微服 务 组 
成 的 系统 中 并 不 能 很 好 地 工作 。 如 果 系 统 有 上 自动 扩展 功能 的 话 ， 该 问题 会 更 严重 。 开 发 
人 员 可 以 很 容易 地 发 现 ， 所 有 服务 的 网 络 地 址 都 是 人 工 管理 的 。 当 然 ， 我 们 也 可 以 考虑 
将 配置 设置 从 每 个 胖 JAR 中 的 application.yml 文件 移动 到 配置 服务 器 。 人 但是， 这样 做 并 
不 能 改变 管理 大 量 交互 仍然 很 麻烦 的 事实 。 通 过 客户 端 负 载 均 衡器 和 服务 发 现 进行 交互 
的 能 力 ， 可 以 轻松 解决 这 样 的 问题 


6.4 将 RestTemplate 与 服务 发 现 结合 使 用 


实际 上 ， 与 服务 发 现 的 集成 是 Ribbon 客户 端的 默认 行为 。 细 心 的 读者 可 能 还 记得 ， 
我 们 可 以 通过 设置 ribbon.eureka.enabled 属性 为 false 禁用 Eureka 作为 客户 并 均衡 器 的 功 
能 。 在 本 节 示 例 中 开发 人 员 将 看 到 ， 服 务 发 现 的 存在 简化 了 对 于 服务 之 间 通 信和 的 Spring 
Cloud 组 件 的 配置 任务 。 

本 示例 的 系统 架构 与 前 一 个 示例 相同 。 要 查看 当前 练习 的 源 代 人 码 ， 必 须 切换 到 
ribbon with discovery 分 文 (https://github.com/piomin/shown here-spring-cloud-comnytree/ 
ribbon with discovery) 。 在 这 里 ， 开 发 人 员 将 看 到 的 第 一 件 事 是 新 模块 ， 即 discovery- 
service (发 现 服务 ) 。 本 书 第 4 章 “ 服 务 发 现 ” 详 细 讨 论 了 与 Eureka 相关 的 几乎 所 有 方 
面 , 因而 局 动 它 时 不 应 该 有 任何 问题 。 我 们 需要 运行 一 个 具有 真正 基本 设置 的 独立 Eureka 
服务 右 ， 和 它 在 默认 端口 8761 上 可 用 。 

与 前 面 的 示例 相 比 ， 我 们 应 该 删除 与 Ribbon 客户 端 严 格 相关 的 所 有 配置 和 注解 。 取 
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而 代 之 的 是 ，Eureka 发 现 客户 端 必须 使 用 (EnableDiscoveryClient 启用， 并且 必须 在 
application.yml 文件 中 提供 Eureka 服务 器 地 址 。 现 在 ，order-service 的 main 类 看 起 来 应 
该 如 下 所 示 。 


QSspringBootApplication 
QEnableDiscoveryClient 

public class OrderApplication 1 
QLoadBalanced 


QBean 
RestTemplate restTemplatel() { 
return new RestTemplate (}; 


} 


public static Vold main(Sstring[||] args) 1 


New 
SpringApplicationBuilder (OrderApplication.class) .web (true) .run(args}):; 


} 
7 
} 


以 下 是 当前 的 配置 文件 。 可 以 使 用 spring.application.name 属性 来 设置 服务 的 名 称 。 
Spring: 


application: 
name: order—-service 


Server: 
port: S${PORT:8090}] 


eureka: 
client: 


SeTVLCeUT1 : 
defaultzone: S${EUREKA URL:http://localhost:8/61/eureka/)} 


这 里 的 设置 和 以 前 是 一 样 的 。 我 们 还 局 动 了 所 有 的 微服 务 。 但 是 ， 这 一 次 account- 
service 服务 和 product-service 服务 的 实例 数 将 乘 以 2。 局 动 每 个 服务 的 第 二 个 实例 时 ， 
可 以 使 用 -DPORT 或 -Dserver.port 参数 窗 新 默认 服务 器 端口 ， 如 java -jar -DPORT=9093 
product-service-1.0-SNAPSHOT.jar。 所 有 实例 都 已 在 Eureka 服务 器 中 注册 ， 这 可 以 使 用 
其 UI 仪 表 板 轻松 查看 ， 如 图 6.2 所 示 。 
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Instances currently registered with Eureka 


Applicatien AhAls Availability Zones 
ACLCLOUNTSERVICE n/a [| (2) 
UsTOWMER-SERVWICE nfall) (1) 
ORDOER-SERVICE nfa (1) (1) 


PRODUCT-SEAVICE n/a (2) (2) 


图 62 查看 已 在 Eureka 服务 器 中 注册 的 实例 


这 是 本 书 第 一 次 看 到 负载 均衡 的 实际 示例 。 默 认 情 况 下 ，Ribbon 客户 端 将 在 微服 务 
的 所 有 已 注册 实例 之 间 平 均 分 配 流量 。 访 算法 称 为 轮 询 调度 (Round Robin ) 。 实 际 上 ， 
这 意味 着 客户 端 会 记 住 它 转发 的 最 后 一 个 请 求 的 位 置 ， 然 后 将 当前 请 求 发 送 到 该 行 中 的 
下 一 个 服务 。 这 个 方法 可 能 会 被 本 书 第 7 章 所 介绍 的 其 他 规则 履 辣 。 通 过 在 ribbon. 
listOfServers 中 设置 以 逗号 分 隔 的 服务 地 址 列表 ,也 可 以 为 没有 服务 发 现 机 制 的 前 一 个 示 
例 配 置 负载 平衡 ， 如 ribbon.listOfServers=localhost:8093 localhost:9093。 回 到 本 示例 应 用 
程序 ，order-service 服务 发 送 的 请 求 将 在 account-service 服务 和 product-service 服务 的 两 
个 实例 之 间 进 行 负 载 均衡 。 这 和 customer-service 服务 是 相似 的 ， 只 不 过 后 者 是 在 account- 
service 服务 的 两 个 实例 之 间 分 配 流 量 。 如 果 开 发 人 员 已 经 启动 了 如 图 6.2 所 示 的 Eureka 
仪表 板 上 的 所 有 服务 实例 ， 并 将 一 些 测试 请 求 发 送 到 order-service 服务 , 则 肯定 会 看 到 以 
下 日 志 。 在 该 日 志 中 ， 我 们 以 加 粗 形式 突出 显示 了 某 些 片段 ， 它 们 是 Ribbon 客户 端 显示 
的 为 目标 服务 找到 的 地 址 列表 。 


DynamicServerListLoadBalancer for client account-—service initialijzed: 
DynamicServerListLoadBalancer: {NFLoadBalancer:name=account—service, 
current list of Servers=[minkowp-1.p4.0rg:8091, minkowp-1.p4.0rg:9091], 
Load balancer stats=2one stats: {defaultzone=[2one:defaultzone; Instance 
count:2; Active connections count: 07 Circuit breaker tripped count: 0; 
Active connections per server: 0.0;| 

},Server stats: [[Server:minkowp— 1.p4.0rg:8091; zone:defaultaone; Total 
Requests:0; Successive connection failure:0; Total blackout seconds:0; 
Last connection made:Thu Jan O01 01:00:00 CET 1970; First connection made: 
Thu Jan 01 01:00:00 CET 197107 Active Connections:0; total falilure 
count in last (1000})} msecs:0; average resp time:0.0; 90 percentile 
resp time:D0 .0; 95 percentile resp Time:0.0; min Tesp time:0.0r max 
resp time:0.0; stddeyv resp time:0.0| ,LServer:mnkowp | .p44.0rg:90913 
one:defaultzone; Total Requests:0; SUuCCessive connection failure:0s 
Total blackout seconds:0; Last connection made:Thu Jan O01 O01:00:00 CET 
1910; First connection made: Tha Jan Ol 01:00:00 CET J9,0; Active 
Connections:0; total failure count in last (1000} msecs:0; average 
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resp time:0.0; 90 percentile resp time:0.0; 9 percentile resp tme:0.0s 
min resp time:0.0; max resp time:0.0; stddeyv resp time:0.0|]} 
ServerList:org.springframework.cloud.netflix.ribbon.eureka. 
DomainExtractingServerListf@3e878e6] 


6.5 使 用 Feign 和 客 尸 端 


RestTemplate 是 一 个 Spring 组 件 ,专门 用 于 与 Spring Cloud 和 微服 务 进行 交互 。 但 是 ， 
Netflix 开发 了 上 自己 的 工具 ， 充 当 Web 服务 客户 端 ， 用 于 在 独立 REST 服务 之 间 提 供 现成 
可 用 的 通信 。 其 中 的 Feign 客户 问 通 第 与 市 有 @LoadBalanced 注解 的 RestTemplate 作用 相 
同 ， 但 是 工作 方式 更 加 从 容 。 它 是 一 个 Java 到 HITP 客户 端 绑 定 器 ， 通 过 将 注解 处 理 为 
模板 化 请 求 来 工作 。 使 用 Open Feign 和 客户 端 时 ， 开 发 人 员 只 需 创 建 一 个 接口 并 对 其 进行 
注解 。 它 与 Ribbon 和 Eureka 集成 ， 提 供 负 载 均衡 的 HITP 客户 端 ， 从 服务 发 现 中 获取 所 
有 必需 的 网 络 地 址 。Spring Cloud 增加 了 对 Spring MVC 注解 的 支持 ， 并 使 用 了 与 Spring 
Web 相同 的 HITTP 消息 转换 器 。 


6.5.1 ”对 不 同 区 域 的 支持 


现在 回 到 上 一 个 示例 ， 我 们 将 对 它 提 出 一 些 更 改 ， 以 使 其 系统 架构 变 得 稍微 复杂 一 
些 。 如 图 6.3 所 示 是 当前 染 构 的 示意 图 。 可 以 看 到 ， 微 服务 之 间 的 通信 模型 仍然 相同 ,但 
现在 我 们 将 对 每 个 微服 务 局 动 两 个 实例 并 将 它们 分 成 两 个 不 同 的 区 域 。 在 本 书 第 4 章 “ 服 
务 发 现 ” 中 讨论 使 用 Eureka 的 服务 发 现时 ， 已 经 详细 介绍 了 分 区 机 制 ， 所 以 我 们 假定 开 
发 人 员 已 经 熟悉 该 内 容 。 本 练习 的 主要 目的 不 仅 是 演示 如 何 使 用 Feign 客户 端 ， 还 将 说 明 
分 区 机 制 如 何 作用 于 微服 务实 例 之 则 的 通信 。 


图 6.3 ”当前 示例 的 架构 
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6.5.2 ”为 应 用 程 友 局 用 Feign 


要 在 项 目 中 包含 Feign， 开 发 人 员 必 须 添加 spring-cloud-starter-feign 工件 的 依赖 项 或 
添加 Spring Cloud Netflix (版 本 至 少 需 要 为 1.4.0) 的 spring-cloud-starter-openfeign 。 
<dependency> 
<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-feign</artifactId> 
</dependency> 
下 一 步 是 通过 使 用 @EnableFeignClients 注解 main 类 或 配置 类 来 为 应 用 程序 启用 
Feign。 此 注解 将 导致 搜索 应 用 程序 中 实现 的 所 有 客户 端 ,开发 人 员 还 可 以 通过 设置 client 
或 basePackages 注解 属性 来 减少 使 用 的 客户 端 数 量 ， 如 @EnableFeignClients (clients= 
{AccountClient.class,Product.class})。 以 下 是 order-service 服务 的 应 用 程序 的 main 类 。 


QSspringBootApplication 
QEnableDiscoveryClient 
QEnableFeignClients 


public class OrderApplication 1 
public static void main(string[] args) { 


New 
SpringApplicationBuilder (OrderApplication.class) .web (true) .run (args):; 


} 


aBean 
OrderRepository repository() |{ 
return new OrderRepository(); 


} 
} 
1. 构建 Feign 接口 
有 一 种 提供 组 件 的 方法 只 需要 创建 市 有 一 些 注解 的 接口 即 可 ， 这 也 是 Spring 
Framework 的 标准 。 对 于 Feign， 接 口 必 须 使 用 @FeignClient(name ="...") 进 行 注解 。 它 有 
一 个 必需 的 属性 名 称 ， 如 果 局 用 了 服务 发 现 ， 则 该 属性 名 称 对 应 于 调用 的 微服 务 名 称 。 


否则 ， 它 与 url 属性 一 起 使 用 ， 在 url 中 可 以 设置 具体 的 网 络 地 址 。 
在 这 里 ，@FeignClient 并 不 是 需要 使 用 的 唯一 注解 。 在 我 们 的 客户 端 界 面 中 ， 每 个 
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方法 都 通过 使 用 @RequestMapping 标记 它 来 与 特定 的 HITP API 端点 相关 联 ， 当 然 也 可 
以 使 用 更 具体 的 注解 ， 如 @GetMapping、@PostMapping 或 @PutMapping， 如 本 示例 源 代 
码 片 段 中 所 示 。 


QFeignClient (name = "account—service") 

public interface AccountClient { 
QPutMapping("/withdraw/{accountIid}/{amount}") 
Account withdraw (PathVariable("accountId") Long id, 

QPathvariable ("amount") int amount) ， 


} 


QFeignClient (name = "customer-service") 
Public interface CustomerClient | 
AGGetMapping("/withAccounts/{customerId}") 
Customer findByIdWithAccounts (QPathVariable("customerId") Long 
customerId); 


} 


QFeignClient (name = "product-service") 
public interface ProductClient { 
@PostMapping ("/ids") 
List<Product> findBylds (List<Long> ids);， 
} 


这 些 组 件 可 以 注入 控制 器 bean， 因 为 它们 也 是 Spring Beans。 然 后 ， 开 发 人 员 只 需要 
调用 其 方法 。 以 下 是 order-service 服务 中 REST 控制 器 的 当前 实现 。 


QAutowired 

OrderRepository repository; 
QAutowired 

AccountClient accountClient; 
QAutowired 

CustomerClient customerClient; 
QAutowired 

ProductcClient productClient,; 


QPostMapping 

public Order prepare (RequestBody Order order) { 
1int price = 0; 
List<Product> products = 

productClient.findByIds (order.getProductlIds () ); 
Customer customer = 
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customerClient.findByIdWithAccounts (DraeTr -getCustormeITId() 1) 
for (Product product : products) 
price += product.getPrice(}; 
fjnal int priceDiscounted = priceDiscount (price, customer}); 
Optional<Account> account = customer.getAccounts () .stream() .filter (a 一 > 
(a.getBalance(} > priceDiscounted})) .findFirst(); 
ift (account.1isPresent(}} 1 
order.setAccountlIid(account .get () .getId(}) ); 
order.setSstatus (Orderstatus.ACCEPTED); 
order-. SetPrice {priceDiscounted}:; 
} else 1 
order.setSstatus (Orderstatus .REJUJECTED) ， 


} 
return repository.add (order),; 

} 

2. 启动 微服 务 


我 们 已 经 更 改 了 application.yml 中 所 有 微服 务 的 配置 .现在 , 有 两 个 不 同 的 配置 文件 ， 
第 一 个 用 于 将 应 用 程序 分 配给 zonel， 第 二 个 用 于 zone2。 开 发 人 员 可 以 查看 feign 
with discovery 分 文 的 版 本 (https://github.com/piomin/shown here-spring-cloud-comm/tree/ 
feign with discovery ) 。 然 后 , 使 用 mvn clean install 命令 构建 整个 项 目 。 应 该 使 用 java -jar 
--spring.profiles.active=zone[n| 命 令 启 动 应 用 程序 ， 其 中 ，[n] 是 区 域 的 编号 。 

因为 必须 启动 许多 实例 来 执行 该 测试 ， 所 以 通过 设置 -Xmx 参数 (如 -Xmx128m) 来 
考虑 对 堆 大 小 的 限制 是 值得 的 。 以 下 是 其 中 一 个 微服 务 的 当前 配置 设置 


Spring: 
application: 
name: account—service 


SpIring: 
Brofrles: zonmnmmli 
eureka: 
instance: 
metadataMap: 
ZONe: ZONned 
cl|ient: 
SerViCeUrl: 
defaultzone: http://localhost:817161/eurekal/ 
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PIeTeTrSame2cneEUTeKa: true 
ET 


port: ${PORT:8091)] 


SpIring: 
profiles: zone2 
eureka: 
instance: 
metadataMap: 
ZONe: ZoONez 
client: 


SEIVICeUTr]: 
defaultz2zone: http://localhost:8161/eurekal/ 
preferSamezoneEureka: true 
Serep: 
port: ${PORT:9091] 


我 们 将 为 每 个 区 域 的 每 个 微服 务 启动 一 个 实例 。 因此， 会 有 9 个 正在 运行 的 Spring 
Boot 应 用 程序 〈 包 括 服务 上 友 现 服务 器 ) ， 如 图 6.4 所 示 。 
Instances currently registered with EUreka 


Application Alils Awailability Zones 


ACCOUNT-SERYVICE na (2) (2 


CUSTOMER-SERVICE na (2) 


ORDERA-SERVICE malea) 


PRODUCT-SERVICE na (2) 


6.4 每 个 区 域 的 每 个 微服 务 都 局 动 了 一 个 实例 


如 果 将 测试 请 求 发 送 到 在 zonel (http://localhost:8090) 中 运行 的 order-service 服务 实 
例 ， 则 所 有 流量 将 转发 到 该 区 域 中 的 其 他 服务 ， 而 对 于 zone2 (http://localhost:9090) 也 
是 一 样 的 。 以 下 以 粗 体 突出 显示 的 是 Ribbon 客户 端 打 印 的 在 当前 区 域 中 注册 的 目标 服务 
的 已 找到 地 址 的 列表 万 段 。 

DynamicServerListLoadBalancer for client product-—service initialized: 

DynamicServerListLoadBalancer: {NFLoadBalancer:name=product—service,current 

11st of Servers=[minkowp-l1.p4.0rg:8093|] ,Load balancer stats=Zone stats: 


{zonel=[Zone:zonel; Instance count:1; Active connections count: 0; Circuit 
breaker tripped count: 0; Active connectlions per server: 0.0;|]... 


a 
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继承 文 持 


开发 人 员 可 能 已 经 注意 到 ， 控 制 器 实现 中 的 注解 和 该 控制 器 所 服务 的 REST 服务 的 
Feign 客户 端 实现 是 相同 的 。 我 们 可 以 创建 一 个 包含 抽象 REST 方法 定义 的 接口 。 该 接口 
可 以 由 控制 器 类 实现 ， 也 可 以 由 Feign 客户 端 接 口 扩展 。 


public interface AccountService 1 


1int 


@PostMapping 
Account add (RequestBody Account account); 


PutMapping 
Account update (GRequestBody Account account ) ， 


QPutMapping("/withdraw/{id}/{amount}") 
Account withdraw (PathVariable ("id") Long id, PathVvariable ("amount") 
amount); 


GGetMapping("/{id}") 
Account findById (PathVvariable("id") Long id); 


GetMapping("/customer/{customerId}") 
List<Account> findByCustomerId (QPathvVvariable ("customerId") Long 


customerId); 


} 


@PostMapping ("/ids") 
List<Account> find(l@RequestBody List<Long> ids); 


QDeleteMapping("/{id}") 
void delete (PathVariable("id") Long id); 


现在 ， 控 制 器 类 为 基本 接口 中 的 所 有 方法 提供 了 一 个 实现 ， 但 不 包含 任何 REST 映 
射 的 注解 。 当 然 , @RestController 注解 还 是 需要 的 。 以 下 是 account-service 服务 控制 占 的 
一 个 片 我 。 


QRestController 
public class AccountController imlements AccountService | 


QAutowired 
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AccountRepository repository; 


public Account add (RequestBody Account account) I 
return repository.add (account); 
} 
A 
} 


用 于 调用 account-service 服务 的 Feign 客户 端 接 口 不 提供 任何 方法 。 它 只 是 扩展 了 基 
础 接口 AccountService。 要 查看 基于 接口 和 Feign 继承 的 完整 实现 ， 可 以 切换 到 以 下 
feign with inheritance 分 文 。 

https://github.com/piomin/shown here-spTring-clLoud-commytreey/y feign with 

inheritance 

以 下 是 一 个 带 继 承 文 持 的 Feign 客户 端 声 明示 例 。 它 扩展 了 AccountService 接口 ， 并 
处 理 了 由 (@RestController 公开 的 所 有 方法 。 


QFeignClient (name = "account-service") 
Public interface AccountClient extends AccountService 1 
} 


6.5.4 ”手动 创建 客 尸 端 


如 果 开 发 人 员 不 太 相 信 像 注解 这 样 的 形式 ， 则 可 以 始终 使 用 Feign Builder API 手动 
创建 Feign 客户 端 。Feign 有 和 若干 个 可 以 目 定 义 的 功能 ， 如 消息 的 编码 器 和 解码 器 或 HITP 


AccountClient accountClient = elLgdnmn-bullLder() -Client (new OkHttpClient ())} 
.encoder (new JAXBEncoder ()) 
.decoder (new JAXBDecoder () ) 
-Contract (new JAXRSContract(})) 
-requestlInterceptor (new BasicAuthRequestInterceptor(" user", 
"password")})) 


.target (AccountClient.class, "http://account-service"™"); 
Pa i LL si 
6.5.5 ”客户 端的 自 定 义 


客户 端的 自 定义 不 仅 可 以 使 用 Feign Builder API 接口 执行 ， 还 可 以 使 用 类 似 注解 的 
形式 来 执行 。 例 如 , 开发 人 员 可 以 通过 使 用 @FeignClient 注解 的 configuration 属性 来 设置 
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它 ， 以 提供 配置 类 。 


QFeignClient (name = "account-service", configuration = 
AccountConfiguration.class) 


以 下 显示 了 一 个 示例 配置 bean。 


QConfiguration 
public class AccountConfiguration 1 
QBean 
Public Contract feignContract() 1 
return new JAXRSContract (); 
} 


QBean 
public Encoder feignEncoder(}) 1 
return new JAXBEncoder ()});} 


} 


Bean 
Public Decoder TeignDecoder() 1 
return new JAXBDecodeT ()}; 


} 


QBean 

public BasicAuthRequestIinterceptor basicAuthRequestinterceptor(}) 1 
return new BasicAuthRequestIinterceptor("user", "password"}); 

} 

} 


Spring Cloud 文 持 通 过 声明 Spring Beans 敌 新 以 下 属性 。 

口 Decoder: 默认 为 ResponseEntityDecoder。 

口 Encoder: 默认 为 SpringEncoder。 

口 Logger: 默认 为 Slf4jLogger。 

口 Contract: 默认 为 SpringMvcContract。 

口 Feien.Builder: 默认 为 HystrixFeien.Builder。 

口 Client: 如 果 启 用 了 Ribbon， 则 为 LoadBalancerFeienClient; 否则 ， 将 使 用 默认 
的 Feign 客户 端 。 

口 Logger.Level: 它 为 Feign 设置 默认 日 志 级 别 。 可 以 在 NONE、 BASIC、HEADERS 
和 FULL 之 间 选 择 。 

口 “Retryer: 它 允 许 在 通信 失败 的 情况 下 实现 重 试 算法 。 
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口 ”ErrorDecoder: 它 允 许 将 HTTP 状态 代码 映射 到 特定 于 应 用 程序 的 异常 。 

口 。、Request.Options: 它 允 许 为 请 求 设置 读 取 和 连接 超时 。 

口 Collection<RequestInterceptor>: 已 注册 的 RequestInterceptor 实现 的 集合 ， 这 些 

实现 将 基于 从 请 求 中 获取 的 数据 执行 某 些 操作 。 
也 可 以 使 用 配置 属性 日 定义 Feign 客户 端 。 例如， 可 以 通过 在 feign.client.config 属性 
前 级 之 后 提供 客户 端的 名 称 来 履 蓄 所 有 可 用 客户 端的 设置 ， 或 者 仅 履 新 单 个 选 定 客户 端 

的 设置 。 如果 将 名 称 设置 为 default 而 不 是 特定 的 客户 端 名 称 ， 则 会 将 其 应 用 于 所 有 Feign 
客户 端 。 使 用 @EnableFeignClients 注解 及 其 defaultConfiguration 属性 时 ， 也 可 以 使 用 与 
前 面 所 述 类 似 的 方式 指定 默认 配置 。appplication.yml 文件 中 提供 的 设置 始终 具有 比 
@Configuration bean 更 高 的 优先 级 。 要 更 改 该 方法 ， 并 且 如 果 开 发 人 员 更 喜欢 使 用 
(@Configuration 注解 而 不 是 YAML 文件 , 则 应 该 将 feign.client.default-to-properties 属性 设 
置 为 false。 以 下 是 account-service 服务 的 Feign 客户 端 配 置 示例 ， 它 设置 了 连接 超时 、 
HTTP 连接 的 读 取 超 时 和 日 志 级 别 。 

feigqn: 

Clent: 
config: 
account—service: 
connectTimeout: 2000 


readTimeout: 5000 
loggerLevel: basic 


66 小 结 


本 章 局 动 了 香干 个 可 以 相互 通信 的 微服 务 。 我 们 讨论 了 诸如 REST 客户 端的 不 同 实 
现 、 多 个 实例 之 间 的 负载 均衡 以 及 与 服务 发 现 的 集成 等 主题 。 在 我 们 看 来 ， 这 些 方面 非 
第 重要 ， 所 以 需要 在 两 个 章节 中 对 它们 进行 更 详细 地 说 明 。 本 章 的 重点 是 介绍 微服 务 之 
间 的 通信 ， 并 且 讨 论 了 与 微服 务 架 构 的 其 他 重要 组 件 的 集成 。 第 7 章 将 演示 负载 均衡 占 
和 REST 和 客户 端的 更 高 级 用 法 ， 特 别 关 注 网 络 和 通信 和 问题。 陪读 完 本 章 之 后 ， 开 发 人 员 
应 该 能 够 在 应 用 程序 中 正确 使 用 Ribbon、Feign， 甚 至 ole 并 将 它们 连接 到 其 
他 Spring Cloud 组 件 。 

在 大 多 数 情 况 下 ， 有 这 些 知 识 束 已 经 足够 了 。 但 是 ， 有 时 开发 人 员 需 要 目 定 义 客户 
谢 负 载 均衡 吉 配 置 或 局 用 更 高 级 的 通信 机 制 ， 如 断路 器 或 回 退 逻辑 。 了 解 这 些 解 决 方案 
及 其 对 系统 中 的 服务 间 通 信 的 影响 非常 重要 。 我 们 将 在 第 7 章 讨 论 它们 。 


第 7 章 高 级 负载 均衡 和 断路 器 


本 章 将 继续 讨论 第 6 章 所 涉猎 的 主题 ， 即 服务 间 通 信 。 我 们 将 把 该 主题 扩展 到 更 高 
级 的 负载 均衡 、 超 时 和 断路 示例 。 

Spring Cloud 提供 的 功能 使 得 微服 务 之 间 的 通信 实现 既 简 单 又 便捷 。 但 是 ,不 应 态 记 
的 是 ， 我 们 在 这 种 通信 中 遇 到 的 主要 困难 均 涉 及 系统 的 处 理 时 间 。 如 果 开 发 人 员 的 系统 
中 有 许多 微服 务 ， 那 么 需要 处 理 的 首要 问题 之 一 就 是 延迟 (Delay) 问题 。 本 章 将 讨论 一 
些 Spring Cloud 功能 ， 这 些 功 能 可 以 帮助 开发 人 员 避 免 延 迟 问 题 。 这 些 延 迟 问 题 是 在 处 
理 单 个 输入 请 求 时 ， 由 于 服务 之 间 的 跳 数 《Hop) 太 多 ， 来 目 多 个 服务 的 啊 应 缓慢 或 服务 
暂时 不 可 用 而 导致 的 。 有 若干 种 策略 都 可 以 处 理 部 分 失败 ， 这 些 策略 包括 设置 网 络 超 时 、 
限制 等 待 请 求 的 数量 、 实 现 不 同 的 负载 均衡 方法 ， 或 者 设置 断路 器 模式 和 回 退 实现 等 。 

我 们 还 将 再 次 讨论 Ribbon 和 Feign 客户 端 ， 这 次 将 重点 关注 其 更 高 级 的 配置 功能 。 
本 章 将 介绍 一 个 全 新 的 库 ， 即 Netflix Hystrix。 该 库 实现 了 断路 器 模式 。 

本 章 将 要 讨论 的 主题 包括 : 

口 ”使 用 Ribbon 客户 端的 不 同 负 载 均衡 算法 。 

为 应 用 程序 启用 断路 器 。 

使 用 配置 属性 自 定义 Hystrix。 

使 用 Hystrix 仪表 板 监 控 服务 间 通 信 。 
联合 使 用 Hystrix 和 Feign 客户 端 。 


bb bl 


7.1 负载 均衡 规则 


Spring Cloud Netflix 提供 了 不 同 的 负载 均衡 算法 ， 以 便 为 用 户 提 供 不 同 的 帮助 。 具 体 
选择 哪 一 种 方法 取决 于 开发 人 员 的 需求 。 在 Netflix OSS 术语 中 , 该 算法 称 为 规则 (Rule)。 
目 定 义 规则 类 应 该 已 经 实现 了 IRule 基本 接口 。Spring Cloud 中 默认 可 用 以 下 实现 。 

口 RoundRobinRule: 此 规则 将 简单 地 使 用 众所周知 的 轮 询 调度 算法 选择 服务 占 ， 

在 该 算法 中 ， 传 入 的 请 求 将 按 顺 序 分 布 在 所 有 实例 上 。 它 通常 用 作 更 高 级 规则 
的 默认 规则 或 回 退 逻辑 ， 此 类 规则 有 ClientConffigEnabledRoundRobinRule 和 
ZoneAvoidanceRnule 等 .例如 ,ZoneAvoidanceRnule 就 是 Ribbon 客户 端的 默认 规则 。 
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口 AvailabilityFilteringRule: 此 规则 将 跳 过 标记 为 电路 跳闸 (Circuit Tripped) 或 具 
有 大 量 并 发 连接 的 服务 器 。 它 还 将 使 用 RoundRobinRule 作为 基 类 。 默认 情况 下 ， 
如 果 HITP 客户 端 连 续 3 次 无 法 与 其 建立 连接 ， 则 实例 会 电路 跳闸。 可 以 使 用 
niws.loadbalancer.<clientrName>.connectionFailureCountThreshold 属性 自 定义 此 方 
法 ,一 旦 实例 电路 跳闸 , 它 将 在 下 一 次 重 试 之 前 的 下 一 个 30 秒 内 保持 这 种 状态 。 
也 可 以 在 配置 设置 中 履 盖 此 属性 。 
口 WeightedResponseTimeRule: 通过 此 实现 ， 实 例 的 流量 转发 右 (Traffic Volume 
Forwarder) 与 实例 的 平均 啊 应 时 间 成 反比 。 换 句 话说 ， 啊 应 时 间 越 长 ， 它 的 权 
重 就 越 小 。 在 这 种 情况 下 ， 负 载 均衡 客户 端 将 记录 服务 的 每 个 实例 的 流量 和 响 
应 时 间 。 
口 BestAvailableRule: 根据 类 说 明文 档 中 的 描述 ， 此 规则 会 跳 过 具有 跳闸 断 路 器 的 
服务 器 ， 并 选择 具有 最 低 并 发 请 求 的 服务 器 。 
@@ 注意 : 
跳闸 断路 器 (Tripped Circuit Breaker ) 是 一 个 取 自 电气 工程 的 术语 ， 它 意味 着 没有 电 
流 流 过 电路 。 在 IT 术语 中 ,， 它 指 的 是 发 送 到 服务 的 连续 请 求 太 多 失败 的 情况 ， 因 此， 客户 
端 上 的 软件 会 立即 中 断 调 用 远程 服务 的 任何 进一步 尝试 ， 以 便 释 放 服 务 器 端的 应 用 程序 。 


7.1.1 WeightedResponseTime 规则 


到 目前 为 止 ， 我 们 通常 都 是 通过 从 Web 浏览 器 或 REST 客户 端 调用 服务 来 手动 测试 
它们 。 但 是 ， 当 前 的 更 改 不 允许 这 样 的 方法 ， 因 为 我 们 需要 为 服务 设置 假 延 迟 ， 并 且 还 
要 生成 许多 HTTP 请 求 。 


7.1.2 引入 Hoverfly 进行 测试 


在 这 一 点 上 ， 我 们 想 引 入 一 个 有 趣 的 框架 ， 它 可 能 是 这 类 测试 的 完美 解决 方案 。 这 
个 框架 就 是 Hoverfly， 它 是 一 种 用 于 存根 (Stub) 或 模拟 HTTP 服务 的 轻 量 级 服务 虚拟 化 
工具 。 它 最 初 是 用 Go 编写 的 ， 但 也 为 开发 人 员 提 供 了 一 个 用 于 管理 Java 中 的 Hoverfly 
的 富有 表现 力 的 API。Hoverfly Java 由 SpectoLabs 维护 ， 它 提供 了 抽象 二 进 制 和 API 调 
用 的 类 、 用 于 创建 模拟 的 领域 专用 语言 (Domain Specified Language, DSL ) ， 以 及 与 JUnit 
测试 框架 的 集成 .这 个 框架 有 一 个 笔者 个 人 非常 喜欢 的 功能 。 天 发 人 员 可 以 通过 调用 DSL 
定义 中 的 一 种 方法 ， 轻 松 地 为 每 个 模拟 服务 添加 延迟 。 要 为 项 目 局 用 Hoverfly， 开 发 人 
员 必 须 在 Maven 的 pom.xml 中 包含 以 下 依赖 项 。 
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<dependency> 
<grouplId>io.specto</groupId> 
<artifactId>hoverfly-Java</artifactId> 
<version>0.9.0</version> 
<scope>test</scope> 

</dependency> 


7.1.3 测试 规则 


本 节 所 讨论 的 示例 可 以 在 GitHub 上 找到 。 要 访问 它 ， 必 须 切换 到 weighted lb 分 文 
(https://github.com/piomin/sample-spring-cloud-comm/tree/weighted lb) 。JUnit 测试 类 名 
为 CustomerControllerTest， 它 位 于 src/test/java 目录 下 。 要 启用 Hoverfly 测试 ， 应 该 定义 
JUnit @ClassRule。HoverflyRule 类 提供 了 一 个 API， 该 API 允许 开发 人 员 使 用 不 同 的 地 
址 、 特 征 〈“Characteristics〉 和 啊 应 来 模拟 许多 服务 。 在 下 面 的 源 代码 片段 中 ， 你 可 能 会 
看 到 我 们 的 示例 微服 务 account-service 的 两 个 实例 已 经 在 @ClassRule 中 声明 。 你 可 能 还 
记得 ， 该 服务 已 经 由 customer-service 服务 和 order-service 服务 调用 。 
现在 来 看 一 看 customer-service 服务 模块 中 的 测试 类 。 它 使 用 端口 8091 和 9091 上 可 
用 的 account-service 服务 的 两 个 实例 的 预定 义 啊 应 来 模拟 GET /customer/* 方 法 。 第 一 个 
延迟 了 200 暑 秒 ， 而 第 二 个 则 延迟 了 50 室 秒 。 
QClassRule 
public static HoverflyRule hoverflyRule = HoverflyRule 
.lnSimulationMode (dsl il 
SeErvVvice ("account-service:8091") 
.dndDelay (200, TimeUnit.MILLISECONDS)}) .forAlLl () 
.det (startsWith("/customer/™")) 
WillReturn(success{"[{\"id\":\"IN\", "number\"™:\"1234567890\", 
Nbalancex" :5 O000}]", "application/json”)}), 
service(" "account-service: 9091") 
-dndDelay (5O0, TimeUnit .MILLISECONDS)}) .forALll'{) 
.get (startsWith("/customer/")) 
-WilljReturn (success{("[{\"id\™":\"2\", "number\"™:\"12345671891\", 
\"balance\™":8 000}]", "application/json"™}))}))}) 
.printSimulationData(); 


在 运行 该 测试 之 前 ， 还 应 该 修改 ribbon.listOfServers 配置 文件 ， 方 法 是 将 其 更 改 为 
listOfServers: account-service:8091，account-service:9091。 只 应 该 在 使 用 Hoverfly 时 进行 
这 样 的 修改 。 

以 下 是 一 个 用 于 测试 用 例 的 test 方法 ， 它 将 调用 由 customer-service 服务 公开 的 GET 
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/withAccounts/ fd 冰点 1000 次 。 在 这 1000 次 中 ， 每 一 次 都 将 使 用 该 客户 所 拥有 的 账户 

列表 ， 依 次 调用 account-service 服务 的 GET customerfcustomerId} 疹 点 。 每 一 次 请 求 都 

将 使 用 WeightedResponseTimeRnule 规则 在 account-service 服务 的 两 个 实例 之 间 进 行 负 载 
GaRunwWith (SpringRunner.class,) 


QSspringBootTest (webEnvironment = WebEnvironment.DEFINED PORT) 
public class CustomerControllerTest { 


private static Logger LOGGER = 
LoggerFactory.getLogger(CustomerControllerTest.class); 


Autowired 
TestRestTemplate template; 
a 


QTest 
public void testCustomerWithAccounts() 1 
for (int i = 0; i < 1000; I++) 1{ 
Customer c = template.getForObject ("/withAccounts/{id}", 
Customer.class, 1);，} 
LOGGER.info("Customer: {}"”, c); 
} 


] 

使 用 加 权 啊 应 规则 (Weighted Response Rule) 实现 的 方法 非常 有 趣 。 在 开始 测试 之 
后 , 传 入 的 请 求 在 两 个 account-service 服务 实例 之 间 以 50:50 的 比例 进行 负载 均衡 。 但 是 ， 
经 过 一 段 时 间 后 ， 大 多 数 都 会 转发 给 具有 更 小 延 运 的 实例 。 

以 笔者 个 人 在 本 地 计算 机 上 启动 的 JUnit 测试 为 例 ， 最 终 ， 病 口 9091 上 的 实例 处 理 
了 731 个 请 求 ， 端 口 8091 上 的 实例 处 理 了 269 个 请 求 。 但 是 ， 在 测试 的 末尾 阶段 ， 该 比 
例 看 起 来 有 点 不 同 ， 并 且 加 权 更 有 利于 具有 较 小 延迟 的 实例 ， 其 中 传 入 流量 在 两 个 实例 
之 间 的 比例 大 致 被 划分 为 4:1。 

现在 ， 可 以 通过 添加 第 三 个 account-service 服务 实例 来 稍微 改变 一 下 我 们 的 测试 用 
例 ， 新 服务 实例 的 延迟 大 约 为 10 秒 。 此 修改 旨 在 模拟 HITP 通信 中 的 超时 。 以 下 是 来 日 
JUnit 的 @ClassRule 定义 的 片段 ， 其 中 最 新 的 服务 实例 将 侦 听 端口 10091。 


service("account-service:100931") 
.andDelay (10000, TimeUnit.MILLISECONDS) .forAll () 
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.get (startsWith("/customer/")) 
.Wil]llReturnt(tsuccess{("[{V\"idM™:\"3\", "number\™: "1234567892\", 
Nbalancev" :1 O0000}]", "application/json”™)) 
相应 地 ， 我 们 还 应 该 在 Ribbon 配置 中 执行 以 下 更 改 ， 以 便 为 最 新 的 account-service 

服务 实例 局 用 负载 均衡 。 
11stofServers: account—service:8091, account-service:9091, account— 
Service:10091 


还 必须 执行 的 最 后 一 项 修改 ， 就 是 RestTemplate bean 声明 。 虽 然 和 上 一 个 测试 用 例 
一 样 ， 它 需要 获得 保留 ， 但 是 在 本 实例 中 ， 开 发 人 员 可 以 将 读 取 和 连接 超时 都 设置 为 1 
秒 ， 因 为 在 测试 期 间 启 动 的 第 三 个 account-service 服务 实例 的 延迟 为 10 秒 ， 所 以 发 送 到 
那里 的 每 个 请 求 都 会 在 1 秒 后 因为 超时 而 终止 。 

QLoadBalanced 

QBean 

RestTemplate restTemplate (RestTemplateBuilder restTemplateBuilder) I 

return restTemplateBuilder 
.SetConnectTimeout (1000) 
.SetReadTimeout (1000) 
(人 

} 

如 果 此 时 运行 与 以 前 相同 的 测试 ， 其 结果 将 不 会 令 人 满意 。 所 有 声明 的 实例 之 间 的 
分 配 将 是 : 420 个 请 求 由 侦 听 端口 8091《〈 延 迟 200 毫秒) 的 实例 处 理 ，468 个 请 求 由 侦 听 
端口 9091 (延迟 50 毫秒 ) 的 实例 处 理 ， 并 且 仍 然 还 有 112 个 请 求 被 发 送 到 第 三 个 实例 ， 
它们 显然 会 由 于 超时 而 被 终止 。 为 什么 会 出 现 这 样 的 统计 数据 呢 ? 我 们 可 以 将 默认 的 负 
载 均衡 规则 从 WeightedResponseTimeRule 更 改 为 AvailabilityFilterineRule, 然后 再 重新 运 
行 测 试 。 经 过 这 样 的 修改 之 后 ， 现 在 将 会 回 第 一 个 和 第 二 个 实例 各 发 送 496 个 请 求 ， 而 
只 有 8 个 请 求 被 发 送 到 第 三 个 实例 ， 并 且 一 秒 超时 。 有 趣 的 是 ， 如 果 将 默认 规则 设置 为 
BestAvailableRule， 则 所 有 请 求 都 将 发 送 到 第 一 个 实例 。 

通过 上 述 示例 ， 相 信 开 发 人 员 已 经 完全 明白 了 Ribbon 客户 端的 所 有 可 用 负载 均衡 规 
则 之 间 的 差异 。 


7.2” 自 定义 Ribbon 客户 端 


可 以 使 用 Spring bean 声明 窗 产 Ribbon 客户 病 的 多 个 配置 设置 。 与 Feign 一 样 ， 它 应 
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该 在 名 为 configuration 的 客户 端 注解 字段 中 声明 ， 如 @RibbonClient(name= "account- service", 
configuration=RibbonConfiguration.class)。 使 用 此 方法 可 以 目 定 义 以 下 功能 。 
口 IClientConfig: 其 默认 实现 是 DefaultClientConfigImpl。 
口 IRule: 此 组 件 将 用 于 确定 应 从 列表 中 选择 哪 一 个 服务 实例 。 值 得 一 提 的 是 ， 
ZoneAvoidanceRnule 实现 类 是 自动 配置 的 。 
口 。、IPing: 这 是 一 个 在 后 台 运 行 的 组 件 。 它 负责 确保 服务 实例 正在 运行 。 
口 ”ServerList<Server>: 这 可 以 是 静态 的 也 可 以 是 动态 的 。 如 果 它 是 动态 的 (由 
DynamicServerListLoadBalancer 使 用 ) ， 那 么 后 台 线 程 将 以 预定 义 的 间隔 刷新 并 
过 滤 列 表 。 默 认 情 况 下 ，Ribbon 使 用 从 配置 文件 中 获取 的 静态 服务 器 列表 。 它 
由 ConfigurationBasedServerList 实现 。 
口 “ServerListFilter<Server> : ”ServerListFilter 同样 是 一 个 组 件 ， 它 将 由 
DynamicServerListLoadBalancer 使 用 ， 可 以 过 滤 从 ServerList 实现 返回 的 服务 
十。 该 接口 有 两 种 实现 ， 即 目 动 配置 的 ZonePreferenceServerListFilter 和 
SelIVeILlstSubsetFllter。 
口 ILoadBalancer: 它 负 责 在 客户 端的 服务 的 可 用 实例 之 间 执 行 负载 均衡 。 默 认 情 
况 下 ，Ribbon 将 使 用 ZoneAwareLoadBalancer。 
口 “ServerListUpdater: 和 它 负 责 更 新 给 定 应 用 程序 的 可 用 实例 列表 。 默 认 情 况 下 ， 
Ribbon 将 使 用 PollingServerListUpdater。 
现在 让 我 们 来 看 一 个 配置 类 示例 ， 它 将 定义 IRule 和 IPing 组 件 的 默认 实现 。 通 过 提 
供 @RibbonClients(defaultConfiguration=RibbonConfiguration.class) 注解， 可 以 为 单个 
Ribbon 客户 端 以 及 应 用 程序 类 路 径 中 可 用 的 所 有 Ribbon 客户 端 定 义 如 下 所 示 的 配置 。 
QConfiguration 
public class RibbonConfiguration 1{ 


aBean 
Public IRule ribbonRule() { 
return new WeightedResponseTimeRule ()});} 


&Bean 
public IPing ribbonPing() 1{ 
return new PingUrl (}; 


} 
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即使 没有 使 用 Spring 的 经 验 ， 开 发 人 员 可 能 也 已 经 猜 到 【〈 基 于 之 前 的 示例 ) ， 这 里 
也 可 以 使 用 properties 文件 目 定义 配置 .在 这 种 情况 下 , Spring Cloud Netflix 将 与 由 Netflix 
提供 的 Ribbon 说 明文 档 中 描述 的 属性 兼容 。 以 下 这 些 类 就 是 受到 支持 的 属性 ， 它 们 应 该 
以 <clientName>.ribbon 为 前 级 ， 或 者 如 果 它 们 适用 于 所 有 客户 端 ， 则 仪 使 用 ribbon 作为 
前 级 。 

NFLoadBalancerClassName: ILoadBalancer 默认 空 现 类 。 
NFLoadBalancerRuleClassName: IRule 默认 实现 类 。 
NFLoadBalancerPingClassName: IPing 默认 实现 类 。 
NIWSServerListClassName: ServerList 默认 实现 类 。 

口 NIWSServerListFilterClassName: ServerListFilter 默认 实现 类 。 

以 下 示例 与 前 面 的 @Configuration 类 相似 ， 它 将 覆盖 Spring Cloud 应 用 程序 使 用 的 
IRule 和 IPing 默认 实现 。 


UUUD 


aCCOUnNt—service: 
ribbon: 
NFLoadBalancerPingClassName: com.netflix.loadbalancer.PingUrl 
NFLoadBalancerRuleClassName: 
com.netflix.loadbalancer.WeightedResponseTimeRule 


7.3 ”市 Hystrix 的 断路 器 模式 


前 文 已 经 讨论 过 Spring Cloud Netflix 中 负载 均衡 髓 算法 的 不 同 实现 。 其 中 一 些 基 于 
监视 实例 啊 应 时 间或 失败 次 数 。 在 这 些 情况 下 ， 人 负载 均衡 器 会 根据 这 些 统计 信息 决定 应 
该 调用 哪 一 个 实例 。 断 路 器 模式 (Circuit Breaker Pattern ) 应 该 被 视 为 该 解决 方案 的 扩展 。 
断路 器 背后 的 主要 思想 非常 简单 ， 受 保护 的 图 数 调 用 将 包含 在 断路 器 对 象 中 ， 该 对 象 负 
责 监 视 故障 调用 的 数量 。 如 果 故 障 达 到 国 值 ， 则 电路 断 开 ， 所 有 其 他 调用 将 自动 失败 。 
通 芝 情况 下 ， 如 果断 路 器 跳 击 ， 则 开发 人 员 会 希望 有 某 种 监控 警报 。 在 应 用 程序 中 使 用 
断路 器 模式 所 市 来 的 一 些 重 要 好 处 是 : 应 用 程序 能 够 在 相关 服务 发 生 故 障 时 继续 运行 ， 
防止 出 现 级 联 故 障 ， 并 且 能 够 给 予 服务 恢复 的 时 间 。 


7.3.1 使 用 Hystrix 构建 应 用 程序 


Netflix 在 其 库 中 提供 了 一 个 名 为 Hystrix 的 断路 器 模式 实现 。 该 库 也 被 包含 在 Spring 
Cloud 的 断路 器 的 默认 实现 中 。Hystrix 还 有 一 些 其 他 有 趣 的 功能 ， 也 应 该 被 视 为 处 理 分 布 
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式 系 统 的 延迟 和 容错 的 综合 工具 。 重 要 的 是 ， 如 果断 路 右 被 断 开 ， 则 Hystrix 会 将 所 有 调用 
重 定向 到 指定 的 回 退 方法 (Fallback Method) 。 回 退 方法 则 在 提供 通用 响应 ， 而 不 需要 依 
赖 网 络 ( 一 般 来 说 ， 会 从 内 存 绥 存 中 读 取 啊 应 或 仅 实 现 为 静态 逻辑 )〉 。 如 果 因 为 某 些 原 因 
必须 执行 网 络 调 用 ， 则 建议 使 用 其 他 的 HystrixCommand 或 HystrixObservableCommand 实 
现 它 。 要 在 项 目 中 包含 Hystrix， 则 应 该 为 Spring Cloud Netflix (请 注意 ， 必 须 是 早 于 1.4.0 
的 版 本 ) 使 用 spring-cloud-starter-netflix-hystrix 或 Spring-cloud-starter-hystrix 启动 器 。 
<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-hystrix</artifactId> 
</dependency> 


1. 实现 Hystrix 的 命令 

Spring Cloud Netflix Hystrix 将 查找 使 用 @HystrixCommand 进行 注解 的 方法 ， 然 后 将 
其 包 囊 在 连接 到 断路 器 的 代理 对 象 (Proxy Object) 中 。 由 于 这 个 原因 ，Hystrix 能 够 监控 
这 种 方法 的 所 有 调用 。 此 注解 目前 仅 适 用 于 标 有 @Component 或 @Service 的 类 。 这 对 于 
我 们 来 说 是 很 重要 的 信息 ， 因 为 我 们 已 经 在 REST 控制 右 类 中 实现 了 与 所 有 先前 示例 中 
调用 的 其 他 服务 相关 的 逻辑 ， 该 控制 器 类 采用 的 标记 是 @RestController 和 注解。 因此， 在 
customer-service 服务 应 用 程序 中 ， 所 有 近 辑 都 已 移 至 新 创建 的 CustomerService 类 ， 然 后 该 
类 将 被 注入 控制 右 bean。 人 负责 与 account-service 服务 通信 的 方法 已 使 用 @HystrixCommand 
进行 了 注解 。 此 外 , 我 们 还 实现 了 一 个 回 退 方法 ， 其 名 称 将 传递 到 fallbackMethod 注解 的 
字段 中 。 此 方法 仅 返 回 一 个 空 列表 。 


QService 
public class CustomerService 1 


@Autowired 

RestTemplate template; 
@Autowired 

CustomerRepository repository; 


A 


QHystrixCommand (fallbackMethod = "findCustomerAccountsFallback") 
public List<Account> findCustomerAccounts (Long id) 1 
Account|| accounts = 
template.getForobject ("http://account-service/customer/{customerId}"™, 
Account [| .class, 1id); 
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return Arrays.stream(accounts) -collect (Collectors.toList(})}); 


} 


public List<Account> findCustomerAccountsFallback (Long 1id) 1{ 
return new ArravyList<>{(}); 


} 
} 


不 要 万 记 用 @EnableHystrix 标记 main 类 ， 因 为 它 会 告诉 Spring Cloud， 应 该 为 应 用 
程序 使 用 断路 器 。 当 然 ， 也 可 以 选择 使 用 @EnableCircuitBreaker 来 注解 一 个 类 ， 它 的 作用 
是 一 样 的 。 出 于 测试 目的 ，account-service.ribbon.listOfServers 属性 应 该 包含 localhost:8091 
和 localhost:9091 服务 的 两 个 实例 的 网 络 地 址 。 

虽然 我 们 已 经 为 Ribbon 客户 端 声明 了 account-service 服务 的 两 个 实例 ， 但 是 在 这 里 
我 们 将 仅 局 动 8091 端口 上 可 用 的 实例 。 如 果 调 用 customer-service 服务 方法 GET 
http://localhost:8092/withAccounts/{id}， 则 Ribbon 将 尝试 对 这 两 个 已 声明 的 实例 之 间 的 每 
个 传 入 请 求 进 行 负 载 均衡 ， 也 就 是 说 ,一旦 接收 到 一 个 包含 账户 列表 的 啊 应 ， 那 么 第 二 
次 将 收 到 一 个 空 账 户 列表 ， 反 之 亦 然 。 这 在 下 面 的 应 用 程序 日 志 片 段 中 可 以 看 得 很 清 
楚 。 要 访问 该 示例 应 用 程序 的 源 代码 ， 开 发 人 员 需 要 切换 到 与 第 6 章 中 的 示例 相同 的 
GitHub 存储 库 的 hystrix basic 分 文 (https://github.conypiomin/sample-spring-cloud-comny/tree/ 
hystrix basic) 。 


{"id":1,"name":"John Scott","type"™: "NEW","accounts":[]} 


{"id":1,"name": "John 

Scott"™","type™.: "NEW","accounts"™: [{"Idn:1 "nunber" :"12345678900 ， 
"balance"™:5000},{"id":2,"number"™:"1234567891","balance":5000},， 
{"id"™:3,"number"™:"123456718 92","balance":0}]} 


2. 使 用 缓存 数据 实现 回 退 

上 一 个 示例 中 提供 的 回 退 实现 非常 简单 。 返 回 空 列表 对 于 在 生产 模式 中 运行 的 应 用 
程序 没有 什么 实际 意义 。 反 之 ， 在 应 用 程序 中 使 用 回 退 方法 则 更 有 意义 ， 例 如 ， 当 请 求 
失败 时 ， 可 以 从 缓存 中 读 取 数 据 。 像 这 样 的 缓存 可 以 在 客户 端 应 用 程序 内 部 实现 ， 或 者 
也 可 以 使 用 第 三 方 工 具 实 现 ， 如 Redis、Hazelcast 或 EhCache。 在 Spring Framework 中 也 
提供 了 最 简单 的 实现 , 并 且 在 将 spring-boot-starter-cache 工件 与 依赖 项 一 起 包含 之 后 即 可 
使 用 。 要 为 Spring Boot 应 用 程序 启用 缓存 ， 应 该 使 用 @EnableCaching 注解 main 或 配置 
类 ， 并 在 以 下 上 下 文 环境 中 提供 CacheManager bean 。 
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QSpringBootApplication 
QRibbonClient (name = "account—service") 
QEnableHystrix 

QEnableCaching 

public class CustomerApplication { 


&LoadBalanced 

aeBean 

RestTemplate restTemplate() I 
return new RestTemplate ()});} 


public static void main(string[l|] args) 1 
New 
SpringApplicationBuilder (CustomerApplication.class) .web (true) .run (args}); 


} 


Bean 
public CacheManager cacheManager() (| 
return new ConcurrentMapCacheManager("accounts"); 


} 


然后 ， 可 以 使 用 @CachePut 注解 来 标记 被 断路 占 包 时 (Wrap) 的 方法 ， 这 将 把 从 调 
用 方法 返回 的 结果 添加 到 缓存 映射 (Cache Map) 。 在 这 种 情况 下 ， 该 映射 被 命名 为 
accounts。 最 后 ， 可 以 通过 直接 调用 CacheManager bean 来 读 取 回 退 方法 实现 中 的 数据 。 
如 果 多 次 重 试 相同 的 请 求 ， 则 开发 人 员 将 看 到 空 的 账户 列表 不 再 作为 啊 应 返回 。 相 反 ， 
该 服务 将 始终 返回 在 第 一 次 成 功 调用 期 间 缓存 的 数据 。 


QAutowired 
CacheManager cacheManager; 
QCachePut ("accounts") 
QHystrixCommand (fallbackMethod = "findCustomerAccountsFallback") 
public List<Account> findCustomerAccounts (Long id)} 1 
Account|[| accounts = 
template.getForObject ("http://account-service/customer/{customerId}", 
Account|[|.class, id); 
return Arrays.stream(accounts) .collect (Collectors.toList())}); 
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public List<Account> findCustomerAccountsFallback(Long id) 1{ 
ValueWrapper w = CacheManager.getCache ("accounts") .get (id}:; 
1 二 (下 1= nully -4 
return (List<Account>) w.get(}); 
} else I 
return new ArravyList<> {();}; 


7.3.2 ” 跳 几 断路 器 


现在 不 妨 来 做 一 个 练习 。 截 至 目前 ， 开 发 人 员 已 经 学 习 了 如 何 使 用 Hystrix 与 Spring 
Cloud 一 起 在 应 用 程序 中 局 用 和 实现 断路 占 ， 以 及 如 何 使 用 回 退 方法 从 绥 存 中 获取 数据 。 
但 是 ， 仍 然 没 有 使 用 跳闸 断路 器 来 防止 负载 均衡 器 调用 故障 的 实例 。 现 在 ， 如 果 故 障 百 
分 比 大 于 30%， 则 我 们 想 要 配置 Hystrix 在 3 次 失败 的 调用 党 试 之 后 断 开 电路 ， 并 防止 
在 接 下 来 的 5$ 秒 内 调用 API 方法 。 测 量 时 间 窗 口 约 为 10 秒 。 为 了 满足 这 些 要 求 ， 开 发 
人 员 必 须 履 盖 若 干 个 默认 的 Hystrix 配置 设置 。 它 可 以 使 用 @HystrixCommand 中 的 
(@HystrixProperty 注解 来 执行 。 

以 下 是 负责 从 customer-service 服务 获取 账户 列表 的 方法 的 当前 实现 。 


QCachePut ("accounts") 
QHystrixCommand (fallbackMethod = "findCustomerAccountsFallback", 
commandProperties = | 

QHystrixProperty (name = 
“execution.1solation.thread.timeoutInMilliseconds", value = "2000")., 

QHystrixProperty (name = "circuitBreaker.requestVolumeThreshold", 
valoe=s= "00", 

QHystrixProperty (name = "circuitBreaker.errorThresholdPercentage"™, 
value = "30™")., 

QHystrixProperty (name = "circuitBreaker.sleepWindowInMilliseconds", 
Value = “5000™m)., 

@HystrixProperty (name = "metrics.rollingstats.timeInMilliseconds"™, 
Value = "10000") 
} 
) 
public List<Account> findCustomerAccounts (Long 1id)} 1 

Account|| accounts = 
template.getForobject ("http://account-service/customer/{customerId}"™, 
Account [| .class, 1id); 

return Arrays.stream(accounts) .collect (Collectors.toList()}; 
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有 关 Hystrix 配置 属性 的 完整 列表 , 请 访问 Netflix 的 GitHub 站 点 (https://github.com/ 
Netflix/Hystrix/wikiConfiguration) 。 本 章 不 会 详细 讨论 所 有 这 些 属性 ， 而 只 是 关注 对 于 
微服 务 之 间 的 通信 来 说 最 为 重要 的 属性 。 以 下 是 我 们 的 示例 中 使 用 过 的 属性 的 列表 及 其 
说 明 。 

口 execution isolation thread.timeoutmMilliseconds: 此 属性 将 设置 以 毫秒 为 单位 的 时 

间 ， 在 此 时 间 之 后 将 发 生 读 取 或 连接 超时 ， 客 户 端 将 终止 命令 执行 。Hystrix 将 
这 种 方法 调用 标记 为 失败 ， 并 执行 回 退 逻辑 。 通 过 将 command.timeout.enabled 
属性 设置 为 false， 可 以 完全 关闭 该 超时 设置 。 默 认 值 为 1000 室 秒 。 
口 circuitBreakerrequestVolumeThreshold: 此 属性 可 以 设置 深 动 窗口 中 将 使 电路 跳 
闻 的 最 小 请 求 数 。 默 认 值 为 20。 在 我 们 的 示例 中 ， 此 属性 被 设置 为 10， 这 意味 
着 前 9 次 申请 即使 全 部 失败 也 不 会 使 电路 跳闸 。 请 注意 ， 在 设置 了 该 值 之 后 ， 
因为 前 面 已 经 假设 如 果 30% 的 传 入 请 求 失败 ， 束 应 该 新 开 电 路 ， 所 以 最 小 的 传 
入 请 求 数 其 实 是 3。 

口 circuitBreaker.eIrorThresholdPercentage: 此 属性 可 以 设置 最 小 错误 百分比 ， 超 过 
此 百分比 会 导致 断 开 电路 ， 系 统 开始 短路 请 求 回 退 逻辑 。 默 认 值 为 50。 在 上 面 
的 示例 中 己 经 将 其 设置 为 30， 因 为 我 们 希望 在 有 30% 的 请 求 失 败 的 情况 下 即 断 
开 电 路 。 

口 circuitBreaker.sleepWindowInMilliseconds: 此 属性 设置 跳闸 电路 和 人 允许 尝试 以 确 
定 是 否 应 再 次 断 开 电路 之 间 的 一 段 时 间 。 在 此 期 间 ， 所 有 传 入 的 请 求 都 将 被 拒 
绝 。 默 认 值 为 5000 (到 秒 ) 。 因 为 我 们 想 在 电路 断 开 后 第 一 次 重新 尝试 调用 之 
前 等 待 10 秒 ， 所 以 将 其 设置 为 10000。 

口 “metrics.rollingStats.timeInMilliseconds: 此 属性 可 以 设置 统计 滚动 窗口 的 持续 时 间 

(以 蝇 秒 为 单位 ) 。 这 是 Hystrix 为 断路 器 的 使 用 和 发 布 而 保留 的 指标 (Metrics ) 

时 间 。 

通过 这 些 设 置 ， 开 发 人 员 可 以 运行 与 前 一 个 示例 相同 的 JUnit 测试 。 我 们 将 使 用 
HoverflyRule 启动 两 个 account-service 服务 存根 。 其 中 第 一 个 将 延迟 200 量 秒 ， 而 第 二 个 
将 延迟 2000 毫秒 ， 该 值 大 于 使 用 execution.isolation.thread.timeoutInMilliseconds 属性 为 
@HystrixCommand 设置 的 超时 (默认 为 1000 毫秒 ) 。 

在 运行 JUnit CustomerControllerTest 后 ， 即 可 查看 打印 的 日 志 。 以 下 就 是 从 笔者 的 机 
器 上 启动 的 测试 中 获取 的 日 志 。 可 以 看 到 ， 第 一 个 请 求 来 自 account-service 服务 ， 被 负载 
均衡 到 第 一 个 实例 ， 延 运 了 200 唉 秒 。 为 方便 查看 ， 笔 者 在 日 志 后 面 以 双 斜 杠 注释 方式 
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给 它 添加 了 标记 (1)， 后 面 的 标记 格式 相同 ， 效 不 装 述 。 

接 下 来 ， 发 送 到 9091 请 口 上 可 用 实例 的 每 个 请 求 因为 再 延迟 2000 宇 秒 ， 所 以 都 会 
在 一 秒 钟 后 因为 超时 而 结束 。 在 发 送 10 次 请 求 之 后 ， 首 次 由 于 故障 而 导致 电路 跳 曾 ， 详 
见 日 志 标 记 (2)。 

然后 ， 在 接 下 来 的 10 秒 内 ， 每 个 请 求 都 由 一 个 回 退 方法 处 理 ， 该 方法 将 返回 缓存 的 
数据 ， 见 日 志 标 记 (3) 和 (4)。 

10 秒 之 后 ， 客 户 问 尝试 再 次 调用 account-service 服务 实例 ， 因 为 它 再 次 被 负载 均衡 
到 延迟 为 200 塞 秒 ， 所 以 它 成 功 了 ， 见 日 志 标 记 ($)。 

这 种 成 功 导 致电 路 的 闭合 。 但 糟糕 的 是 , 接 下 来 的 account-service 服务 实例 仍然 啊 应 
绥 慢 〈 因 为 又 要 延迟 2000 毫秒 ) ， 因 而 上 述 情况 会 再 次 发 生 ， 直 到 JUnit 测试 结束 ， 见 
日 志 标 记 (6) 和 (7)。 

以 上 就 是 关于 Hystrix 的 断路 邵 在 Spring Cloud 中 的 工作 方式 的 详细 说 明 。 


16:54:04+01:00 Found response delay settIng for this request host: 
{account-service:8091 200} // (1) 

16:54:05+01:00 Found response delay settijing for this request host: 
{account-service:9091 2000)} 

16:54:05+01:00 Found response delay setting for this request host: 
{account-service:8091 200} 

16:54:06+01:00 Found response delay setting for this request host: 
{account-service:9091 2000} 

16:54:06+01:00 Found response delay settijng for this request host: 
{account-service:8091 200] 


16:54:09+01:00 Found response delay setting for this request host: 
{faccount-service:9091 2000} // (2) 

16:54:10.137 Customer [id=1], name=John Scott, type=NEW, accounts=[Account 
[id=1, number=1234567890, balance=5000]]] // (3) 


16:54:20.169 Customer [id=1, name=John Scott, type=NEW, accounts=[Account 
[id=1, number=1234567890, balance=5000]]] // (4) 

16:54:20+01:00 Found response delay setting for this request host: 
{account-service:8091 200} // (5) 

16:54:20+01:00 Found response delay setting for this request host: 
{account-service:9091] 2000] 

16:54:21+01:00 Found response delay settijng for this request host: 
{account-service:8091 200}) 


16:54:25+01:00 Found response delay setting for this request host: 
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{account-service:8091 200} // (6) 
16:54:26.157 Customer [id=1], name=John Scott, type=NEW, accounts=[Account 
[id=1, number=1234567890, balance=5000]]] // (7) 


7.4 ”监控 延迟 和 容错 


如 前 文 所 述 ，Hystrix 并 不 是 一 个 仅 能 实现 断路 器 模式 的 简单 工具 。 它 是 一 种 可 以 处 
理 分 布 式 系统 中 延迟 和 容错 的 解决 方案 。Hystrix 提供 的 一 个 有 趣 功能 是 能 够 公开 与 服务 
间 通 信 相 关 的 最 重要 指标 ， 并 通过 用 户 界 面 仪表 板 显示 它们 。 此 功能 适用 于 使 用 Hystrix 
命令 包 庄 的 客户 端 。 

在 之 前 的 一 些 示 例 中 ， 我 们 仅 分 析 了 系统 的 一 部 分 ， 以 模拟 customer-service 服务 和 
account-service 服务 之 间 的 通信 延 人 运 。 在 测试 高 级 负载 均衡 算法 或 不 同 的 断路 器 配置 设置 
时 ， 这 是 一 个 非常 好 的 方法 ， 但 现在 我 们 将 回 过 头 来 分 析 为 一 组 独立 的 Spring Boot 应 用 
程序 设置 的 作为 一 个 一 体 化 的 示例 系统 ， 这 将 使 得 开发 人 员 能 够 观察 Spring Cloud 与 
Netflix OSS 工具 一 起 工作 的 方式 ， 了 解 它 们 如 何 帮助 监控 和 响应 微服 务 之 间 的 通信 中 的 
延迟 和 失败 问题 。 该 示例 系统 将 以 简单 的 方式 模拟 故障 。 它 具有 静态 配置 ， 其 中 包括 
product-service 服务 和 account-service 服务 的 两 个 实例 的 网 络 地 址 ， 但 每 个 服务 只 运行 其 
中 一 个 实例 。 

为 了 加 深 印 象 并 区 别 于 上 一 个 示例 ， 本 示例 的 系统 架构 考虑 了 有 关 故 障 的 假设 ， 其 
示意 图 如 图 7.1 所 示 。 


图 7.1 本 示例 的 系统 架构 
这 一 次 的 测试 也 有 上 所 不 同 。 以 下 是 测试 方法 的 户 段 ， 它 在 循环 中 被 调用 。 首 先 ， 
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将 调用 order-service 服务 的 POST http://localhost:8090/ 端 点 ， 发 送 Order 对 象 ， 并 接收 具 
有 id、status 和 price 和 集合 的 啊 应 。 该 请 求 在 图 7.1 中 被 标记 为 Q)，order-service 服务 与 
product-service 服务 和 customer-service 服务 通信 ， 此 外 ，customer-service 服务 将 调用 
account-service 服务 的 端点 。 如果 订 单 己 被 接收 ， 则 测试 客户 端 将 使 用 订单 的 id 调用 PUT 
http://localhost:8090/{id} 方 法 接收 该 订单 并 从 该 账户 中 提取 资金 。 在 服务 器 端 ， 这 种 情况 
下 只 有 一 个 服务 间 通 信 ， 在 图 7.1 中 标记 为 握 。 在 运行 此 测试 之 前 ， 必 须 启动 属于 系统 一 
部 分 的 所 有 微服 务 。 

Random Ir = new Randadom () ; 

Order order = new Order(}); 

order.setCustomerld((long} r.nextIint (3)+1); 

order.setProductlIds (Arrays.asList (new Long[|] { (long) r.nextInt (10}+]1, (long) 

r.nextIint {10+}); 

order = template.postForObject ("http://localhost:8090™, order., 

Order.class); // 对 应 图 7.1 中 的 必 

if {order.getstatus{} := Orderstatus -REJECTIED) 1 

template.put ("http://localhost:8090/{id}", null, order.getId(}}); // 对 
应 图 7.1 中 的 @ 
} 


7.4.1 公开 Hystrix 的 指标 流 


使 用 Hystrix 与 其 他 微服 务 进行 通信 的 每 个 微服 务 都 可 能 公开 使 用 Hystrix 命令 包 于 
的 每 个 集成 的 指标 。 要 局 用 此 类 指标 流 (Metrics Stream) ， 应 该 在 spring-boot-starter-actuator 


上 包含 依 赖 项 ， 这 会 将 /hystrix.stream 对 象 公开 为 管理 端点 。 此 外 ， 开 发 人 员 还 必须 包含 
spring-cloud-starter-hystrixz， 因 为 它 已 经 被 添加 到 我 们 的 示例 应 用 程序 中 。 
<dependency> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 
己 经 生成 的 流 将 进一步 公开 为 JSON 条 目 , 这 些 JSON 条 目 中 将 包含 表示 方法 中 的 单 
一 调用 的 特征 的 指标 。 以 下 是 来 目 customer-service 服务 的 GET /withAccounts/{id} 方 法 中 
的 单个 条 目 。 


{"type™": "HystrixCommand", "name": "customer-service.findWithAccounts", 
“OUD : “CusStomrService  , CurrentTime 15130892048982. 
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“1SC1irculitBreakeropen :false, errorPercentage” :0, errorCount” :0, 


"PEESstEeanmnt 


14,"rollingCountBadRequests":0, 


"rollingCountcollapsedRequests"” :0, "rollingCountEmit":0, 


“rollingCountExceptionsThrown” :0, "rollingCountFailure” :0, 
“rollingCountFallbackEmit"”":0, "rollingCountFallbackFailure™":0, 
“rollingCountFallbackMissing :0, "rollingCountFallbackReection”":0, 


“rollingCountFallbackSuccess"” :0, "rollingCountResponsesFromCache”" :0, 


“rollingCountSemaphoreRejJected"”:0, "rollingCountshortCircuited™ :0, 
“OllingCountSuccess” :135, "rollingCountThreadPoolRe ected™ :0. 


“rollingCountTimeout"™:0,"currentConcurrentExecutionCount™:0, 


“rollingMaxConcurrentExecutionCount":1," "latencyExecute mean :>， 
"TatencCvyExecute st "30. 259 350 50 0 To. 0 516. YY5 2031, 


“an, “995 


"atencyTotal”: 
:2 


和 
"propertyValue 
"propertyValue 
“propertyValue 
"propertyValue 
"propertyValue 
“propertyValue 
“propertyValue 
"propertyValue 
"propertyValue 
“propertyValue 
“propertyValue 
"propertyValue 
"propertyValue 


:41,"100":621}," "latencyTotal mean :5， 


el he I LD ns 


circuitBreakerRequestVolumeThreshold"”:10, 
circuitBreakerSleepWindowInMilliseconds"™":10000, 
CircuitBreakerErrorThresholdPercentage” : 30, 
circuitBreakerForceOpen" :false, 
circuitBreakerForceClosed":false, 
circuitBreakerEnabled":true, 
executijonIsolationstrategy"”: "THREAD", 
executionIsolationThreadTimeoutInMilliseconds™”:2000, 
executionTimeoutInMilliseconds™:2000,， 
executljonlIsolationThreadInterruptonTimeout™" :true, 
executionIsolationThreadPoolKeyOverride" :null, 
executionIlsolationSemaphoreMaxConcurrentRequests"™:10, 
fallbacklIsolationSemaphoreMaxConcurrentRequests":10, 


"propertyValue metricsRollingstatisticalWindowInMilliseconds"”:10000, 


“PropertyValue requestCacheEnabled” :true, 


"propertyValue requestLogEnabled" :true, reportingHosts":1, 


"threadPool™:"Custom erService"l} 


7.4.2 ”Hystrix 仪表 板 


Hystrix 仪表 板 将 可 视 化 以 下 信息 。 


UU 


运行 状况 和 流量 将 显示 为 一 个 圆 财 ， 这 个 圆 联 会 更 改 其 颜色 和 大 小 ， 以 有 反映 传 


入 的 统计 信息 的 更 改 。 


UU 


过 去 10 秒 内 的 错误 百分比 。 
按 数 字 显 示 最 后 两 分 钟 的 请 求 率 ， 在 图 表 上 显示 结果 。 
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口 断路 器 状态 。 断 开 为 Open， 闭 合 为 Closed。 
口 ”服务 主机 的 数量 。 

口 ”最 后 一 分 钟 的 延迟 百 分 位 数 。 

口 ”服务 的 线程 池 。 


1. 使 用 仪表 板 构建 应 用 程序 


Hystrix 仪表 板 与 Spring Cloud 集成 在 一 起 。 在 系统 内 部 实现 仪表 板 时 ， 最 好 的 方法 是 
将 独立 的 Spring Boot 应 用 程序 与 仪表 板 分 开 。 要 在 项 目 中 包含 Hystrix 仪表 板 ， 可 以 使 
用 spring-cloud-starter-hystrix-netflix-dashboard 局 动 右 ; 对 于 Spring Cloud Netflix 来 说 出 
是 使 用 spring-cloud-starter-hystrix-dashboard。 请 注意 ，Spring Cloud Netflix 版 本 必须 早 
Ei 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-hystrix-dashboard</artifactId> 

</dependency> 

应 用 程序 的 main 类 应 该 使 用 (@EnableHystrixDashboard 进行 注解 。 在 启动 之 后 ， 

Hystrix 仪表 板 即 在 /hystrix 上 下 文 路 径 下 可 用 。 

QSpringBootApplication 

QEnableHystrixDashboard 

public class HystrixApplication | 


public static void main(string[|] args) 1 
new 
SpringApplicationBuilder (HystrixApplication.class) .Web (true) .run(args}; 


} 
} 


本 示例 系统 已 经 将 疹 口 9000 配置 为 Hystrix 应 用 程序 的 默认 设置 ， 并 且 这 是 在 
hystrix-dashboard 模块 中 实现 的 。 因 此 ， 在 启动 hystrix-dashboard 后 ， 如 果 在 Web 浏览 
中 调用 http://localhost:9000/hystrix 地 址 ， 它 将 显示 如 图 7.2 所 示 的 页 面 。 在 该 页 面 ， 开 发 
人 员 应 该 提供 Hystrix 流 奖 点 的 地 址 ， 以 及 可 选 的 标题 。 如 果 要 显示 从 order-service 服务 
调用 的 所 有 端点 的 指标 , 可 输入 地 址 http://localhost:8090/hystrix.stream, 然后 单 击 Monitor 
Steam (监控 流 ) 按钮 。 
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MS 


Sl 


YS 
RI 


入 
ES 


六 


Hystrix Dashboard 
http:;/ localhost:8000/hystrix, stream 


Cinster Vig Turbine rdefault clusteri: http:/iturbine-hostname:portiturbine.straam 
Cluster via Turpbine (Cusiom cluster): http:iiturbine-hostname:port/turbine.stream?cluster=[clusterName| 
Single Fvsiriy 车 http:i /hystrix-app:port/hystrix stream 


ITILS 


Delay: 2000 


Title: order-service 


| Monitar Stream | 


图 7.2 ”hystrix-dashboard 仪表 板 界面 
监控 仪表 板 上 的 指标 


现在 我 们 将 介绍 如 何 调 用 customer-service 服务 的 GET /withAccounts/{id} 方 法 。 
被 @HystrixCommand 包 了 时， 显示 在 Hystrix 仪表 板 上 ， 并 且 在 customer-service 
findWithAccounts 标题 下 ， 取 目 commandKey 属性 。 此 外 ， 


是 CustomerService。 
QService 


用 户 界面 仪表 板 还 将 显示 有 关 
分 配给 每 个 Spring Bean ep 这 些 线程 池 提 供 了 使 用 Hystrix 命令 包 庄 方法 
的 实现 。 在 这 种 情况 下 ， 它 


Public class CustomerService | 
// 


QCachePut ("customers") 


QHystrixCommand (commandKey = 
fallbackMethod = 


customer-service.ftindWithAccounts 

"findCustomerWithAccountsFallback" 
commandProperties = 1 

QHystrixProperty (name 


execution.1isolation.thread.timeoutInMilliseconds 
QHystrixProperty (name 


: Value = "2000") 
"CircuitBreaker.requestVolumeThreshold"™ 


Value = "10") 
QHystrixPproperty (name 


circuitBreaker.errorThresholdPercentage 


QHystrixProperty (name 


value = "30") 
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“circuitBreaker.sleepWindowInMilliseconds", walue = "10000"™), 
QHystrixProperty (name = 
“metrics.rollingstats.timeInMilliseconds", value = "10000™) 


}) 


public Customer findCustomerWithAccounts (Long customerld) :| 
CuUuStomer customer = 
template.getForobject ("http://customer—-service/withAccounts/{iqd}", 
Customer.class, customerId); 
return customer; 


public Customer findCustomerWithAccountsFallback (Long customerld)} (| 
ValueWrapper W = 
cacheManager.getCache( customers") .get (customerld}; 
i (tw = null 1 
return (CuUstomeT) w.get(); 
} else 1 
return new Customer () ， 


} 
如 图 7.3 所 示 是 JUnit 测试 开始 后 Hystrix 仪表 板 的 屏幕 截图 。 在 该 图 中 ， 我 们 监视 
的 是 使 用 @HystrixCommand 包 时 的 所 有 3 个 方法 的 状态 ,正如 预期 的 那样 , product-service 
服务 的 fndByIds 方法 的 电路 已 经 断 开 。 几 秒 钟 之 后 ，account-service 服务 的 withdraw 方 
法 的 电路 也 已 经 断 开 。 
Hystrix Stream: order-service 


Circuit Sort: Error then Volume | Alphabetical | Volume | Error | Mean | Median | 90 | 99 | 99.5 Be 


product-service.findBylds cust,,ice,findWithAccounts account=-service.withdraw 
] | 站 | | 
0|0 


5 28.0 % -23|1|16.0% 
| 「 0|10| 
| 0 | 0 | 

| | | | 

| Hast 履 了 及 f Host: 0.6/S 

Cluster- O.7TIS Cluster: .6/s 

Cireuyit Open Clreult 人 SEE 本 Clreult Closed 

.| sDth 1044mmis Hosts 1 SUth 634ms Hosis 1 gDth Oms 

95ms -99th 1202ms hedian #24ms _ 393th 2002ms hledian ms 93th Ums 

491ms 3953.5th 1202ms Mean 624ms 99.5th 2002ms Mean 0ms 9.th Oms 


Thread Pools sort: Alphabetical | Volume | 
ProductService CustomerService AccountService 
Host 性/ Host- O.5/s Host- 0O.2/s 
Cluster 0 ,7Is Cluster 0.5/s -cluster 0 ,2is 
hlax Active Max Mctira Brtive ax Actia 


Execuyutions | Executions (USLed Execuyutions 
DUeUe SFEe DUSUe See Po Size DUSsUe See 


73 JUnit 测试 开始 后 Hystrix 仪表 板 的 屏幕 截图 
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片刻 之 后 ， 情 况 将 会 稳定 下 来 。 所 有 电路 都 保持 闭合 状态 ， 因 为 只 有 一 小 部 分 流量 
被 发 送 到 应 用 程序 的 非 活 动 实例 .这 显示 了 Spring Cloud 与 Hystrix 和 Ribbon 的 强大 功能 。 
系统 能 够 目 动 重新 配置 上 自身， 以 便 根据 负载 均衡 器 和 断路 齿 生 成 的 指标 将 大 多 数 传 入 请 
求 重 定 同 到 工作 实例 ， 如 图 7.4 所 示 。 


Hystrix Stream: order-service 


Circuit Sort: Error then Volume | Alphabetical | Volme | Error | Mean | Median | S30 | 99 | 398.5 Suc 


product-service .findBylds cust,,ice.findWithAccounts account-service,withdraw 
21 0 1.0 % _ 3 0 0.0 % a | 0 0.0 % 


机 Ne ; | A 关 
0 | ] be Nd . 0 | | dl a 0 


Pt 人 1 入; 0 
| p= 站 


Host: 5.8/s 村 Host: 5.7/s | Host: 5.71s 

Cluster: §.8/s Cluster: 与 .7 号 Cluster: 5.7/S 

Clreult Glosed Glreult Gloseg Gireult Glosed 

Hosts 1 90th 1 1 Ss0th 22ms Hosts 1 goth gms 
Madian LE gy9th edian 二 3FYi 芝 99th ?ms Median 局 rm 过 guth 17ms 
Mean 1ims 99 53th dd4ms ean 19ms 995th £07ms Mean 1ims 995th 37ms 


Thread Pools sort: Alphabetical | Volume | 
ProductService CustomerService AccountService 


Host- 与. 如 Host: 5.7/s Host: 5.71s 

Cluster: 号 .有 后 Cluster 5 Ts Cluater 0 Ts 

Active Wax Active 1 Bciive Vax Active 1 Prtwe Ma % PACctive 1 
DUueued Execubons 58 Duewed Executions 57 Dueued 0 Executionms 号 了 
Pool Size QUBUE SIzZe 5 Pool Size QUSUe Size 后 Pool Size QUeUEe SrE 上 5 


7.4 进入 稳定 工作 状态 的 Hystrix 仪表 板 显 示 

3. 使 用 Turbine 聚集 Hystrix 的 流 

开发 人 员 可 能 已 经 注意 到 ， 我 们 只 能 在 Hystrix 仪表 板 中 得 看 该 服务 的 单个 实例 。 当 
我 们 显示 order-service 服务 的 命令 状态 时 , customer-service 服务 和 account-service 服务 之 
间 的 通信 便 没 有 指标 数据 ， 反 之 亦 然 。 可 以 想象 ， 如 果 order-service 服务 有 多 个 实例 在 运 
行 ， 那 肯定 会 使 我 们 手忙脚乱 ， 因 为 必须 在 Hystrix 仪表 板 中 的 不 同 实 例 或 服务 之 间 定 期 
切换 。 笠 运 的 是 ， 有 一 个 名 为 Turbine 的 应 用 程序 ， 它 可 以 将 所 有 相关 的 /hystrix.stream 
症 点 聚合 到 一 个 组 合 的 /turbine.stream 中 , 使 我 们 能 够 轻松 监控 整个 系统 的 整体 运行 状况 。 

(1) 启用 Turbine 

在 做 出 修改 以 便 为 示例 应 用 程序 启用 Turbine 之 前 ， 应 该 从 启用 服务 发 现 开 始 ， 这 是 
启用 Turbine 所 必须 的 。 切 换 到 hystrix with turbine 分 支 以 访问 支持 使 用 Eureka 进行 服 
务 发 现 并 使 用 Turbine 聚合 Hystrix 流 的 示例 系统 版 本 。 要 为 公开 用 户 界 面 仪 表 板 的 项 目 
启用 Turbine， 只 需 在 依赖 项 中 包含 spring-cloud-starter-turbine， 并 使 用 @EnableTurbine 
注解 应 用 程序 的 main 类 。 


<dependency> 


<groupId>org.springframework.cloud</groupId> 
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<artifactId>spring-cloud-starter-turbine</artifactId> 

</dependency> 

turbine.appConfig 配置 属性 是 Turbine 将 用 于 查找 实例 的 Eureka 服务 名 称 的 列表 。 然 
后 ， 可 以 在 URL (http://localhost:9000/turbine.stream) 下 的 Hystrix 仪表 板 中 使 用 Turbine 
流 。 该 地址 也 可 以 由 turbine.aggregator.clusterConfig 属性 的 值 确定 ,如 http://localhost:9000/ 
turbine.stream?cluster=<clusterName>。 如 果 该 名 称 是 default， 则 可 以 省 略 cluster 参数 。 以 
下 是 Turbine 配置 ， 它 可 以 将 所 有 Hystrix 的 可 视 化 指标 结合 在 一 个 用 户 界 面 仪表 板 中 。 

turbine: 

appConfig: order—service,;cCcustomer—service 
clusterNameExpression: " default" 

现在 ， 整 个 示例 系统 的 所 有 Hystrix 指标 都 显示 在 一 个 仪表 板 站 点 中 。 我 们 需要 显 

的 只 是 监视 统计 信息 流 , 这 可 在 http:Wlocalhost:9000/turbine.stream 下 找到 , 如 图 7.5 月 re 


Hystrix Stream: http://localhost:9000/turbine.stream 


ph 
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图 7.5 聚合 所 有 Hystrix 指标 


开发 人 员 也 可 以 通过 提供 一 个 具有 turbine.aggregator.clusterConfig 属性 的 服务 的 列表 
来 为 每 个 服务 配置 一 个 集群 。 在 这 种 情况 下 ， 开 发 人 员 可 以 通过 提供 具有 http://localhost: 
9000/turbine.stream?cluster=ORDER-SERVICE 参数 的 服务 名 cluster 在 集群 之 间 切 换 。 访 
集群 的 名 称 必 须 以 大 写 形 式 提 供 ， 因 为 Eureka 服务 器 返回 的 值 是 大 写 的 。 
turbine: 
aggregator: 


clusterConfig: ORDER—SERVICE, CUSTOMER—SERVICE 
appConfig: order—service, CUStoOmeIT 一 SeTV1ILCEe 


默认 情况 下 , Turbine 将 在 Eureka 中 己 注 册 实 例 的 homePageUrl 地 址 下 查找 该 实例 的 
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/hystrix.stream 端点 ， 然 后 它 会 将 /hystrix.stream 附加 到 该 URL。 本 示例 应 用 程序 的 
order-service 服务 是 在 靖 口 8090 下 启动 的 ， 因 此 ， 还 应 该 将 默认 管理 端口 宪 亲 到 8090。 
order-service 服务 的 当前 配置 显示 在 以 下 代码 片段 中 。 或 者 ， 开 及 人 员 也 可 以 使 用 eureka. 
instance.metadata-map.management.port 属性 更 改 该 疹 口 。 

Spring: 


application: 
name: order—-service 


SEPVer: 
port: StPORT:8090] 


eureka: 
clent: 
SeErVICeUrlL: 
defaultzone: SS{EUREKA URL:http://localhost:817161/eureka/} 


management: 
security: 
enabled: false 
port: 8090 


(2) 通过 流传 输 局 用 Turbine 
虽然 经 典 Turbine 模块 可 以 从 所 有 分 布 式 Hystrix 命令 中 提取 指标 ， 但 这 并 不 总 是 一 
个 好 选择 。 诸 如 从 HTTP 端点 收集 指标 数据 之 类 的 操作 也 可 以 使 用 消息 代理 以 异步 方式 
实现 。 要 通过 流传 输 (Streaming) 启用 Turbine， 应 该 在 项 目 中 包含 以 下 依赖 项 ， 然 后 再 
使 用 @EnableTurbineStream 注解 主 应 用 程序 。 虽然 以 下 示例 使 用 了 RabbitMQ 作为 默认 的 
消 恩 代理， 但 是 开发 人 员 也 可 以 通过 包含 spring-cloud-starter-stream-kafka 来 使 用 Apache 
Kafka. 
<dependency> 
<oqrouplId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-starter-turbine-stream</artifactId> 
</dependency> 
<dependency> 
<OrouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-stream-rabbit</artifactId> 
</dependency> 


上 述 代 码 中 的 依赖 项 应 包含 在 服务 句 端 。 对 于 客户 问 应 用 程序 来 说 ， 这 些 是 order- 
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service 服务 和 customer-service 服务 , 开 友 人 员 需 要 添加 spring-cloud-netflix-hystrix-stream 
Fe. 如 果 已 经 在 本 地 运行 消息 代理 ， 则 和 它 应 该 已 在 自动 配置 的 设置 上 成 功 运行 。 开 发 人 
也 可 以 使 用 Docker 容器 运行 RabbitMQ， 就 像 我 们 在 本 书 第 $5 章 “ 使 用 Spring Cloud 
i 进行 分 布 式 配置 ”的 Spring Cloud Config 集成 使 用 AMQP 的 示例 中 所 做 的 那样 。 
然后 ， 开 发 人 员 应 该 在 application.yml 中 为 客户 端 和 服务 器 端 应 用 程序 履 盖 以 下 属性 。 
Spring: 
rabbitmg: 
host: 192.168.99.100 
port: v612 


usSername: guest 
password: guest 


如 果 登 录 到 http://192.168.99.100:15672 下 的 RabbitMQ 管理 控制 台 , 开发 人 员 将 看 到 
在 本 示例 应 用 程序 启动 后 创建 了 名 为 springCloudHystrixStream 的 新 交换 消息 。 现 在 ， 我 
们 唯一 要 做 的 就 是 运行 和 上 一 小 节 的 经 典 Turbine 方法 示例 相同 的 JUnit 测试 ， 所 有 指 
ar 忌 代 理发 送 ， 并 且 可 以 在 http://localhost:9000 端点 下 观察 。 如 果 开 发 人 

员 想 要 自己 尝试 ， 可 切换 到 hystrix with turbine stream 分 支 (有 关 详 细 人 信息， 请 参阅 
tpg rio on sno Wrage 5 


7.5 ”故障 和 市 有 Feign 的 断路 器 模式 


默认 情况 下 ，Feign 客户 端 与 Ribbon 和 Hystrix 集成 在 一 起 。 这 意味 着 ， 如 果 开 发 人 
员 愿 意 的 话 ， 可 以 在 使 用 该 库 时 应 用 不 同 的 方法 来 处 理 系统 中 的 延迟 和 超时 。 第 一 种 方 
法 是 Ribbon 客户 端 提 供 的 连接 重 试 机 制 ， 第 二 种 方法 是 断路 器 模式 和 Hystrix 项 目下 可 
用 的 回 退 实现 ， 这 已 在 本 章 前 面 的 章节 中 讨论 过 


7.5.1 重 试 与 Ribbon 的 连接 


使 用 Feien 库 时 ， 默 认 情 况 下 会 为 应 用 程序 局 用 Hystrix。 这 意味 着 如 果 开 发 人 员 不 
想 使 用 它 , 则 应 在 配置 设置 中 禁用 它 。 为 了 使 用 Ribbon 测试 重 斌 机制, 建议 禁用 Hystrix。 
为 了 启用 Feign 的 连接 重 试 ， 只 需 设置 两 个 配置 属性 -MaxAutoRetries 和 MaxAutoRetries 
NextServer。 在 这 种 情况 下 ， 重 要 的 设置 也 是 ReadTimeout 和 ConnectTimeout。 所 有 这 些 
都 可 以 在 application.yml 文件 中 履 靖 。 以 下 是 最 重要 的 Ribbon 设置 列表 。 

口 MaxAutoRetries: 这 是 同一 服务 器 或 服务 实例 上 的 最 大 重 试 次 数 。 第 一 次 尝试 被 
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排除 在 此 计数 之 外 。 
口 、MaxAutoRetriesNextServer: 这 是 要 重 试 的 下 一 个 服务 器 或 服务 实例 的 最 大 数量 ， 
不 包括 第 一 个 服务 器 。 


口 OkToRetryOnAllOperations: 这 表示 可 以 为 该 客户 端 重 试 所 有 操作 。 
口 “ConnectTimeout: 这 是 等 待 与 服务 器 或 服务 实例 建立 连接 的 最 长 时 间 。 
口 ReadTimeout: 这 是 建立 连接 后 等 等 服务 器 啊 应 的 最 长 时 间 。 
现在 假设 已 经 有 两 个 目标 服务 的 实例 。 与 第 一 个 服务 实例 的 连接 已 经 建立 ， 但 是 啊 
应 速度 太 慢 , 发 生 超时 。 客户 端 将 根据 MaxAutoRetries=1 属性 对 该 服务 实例 执行 一 次 重 试 。 
如 果 仍 未 成 功 ， 则 尝试 连 接 该 服务 的 第 二 个 可 用 实例 。 根 据 MaxAutoRetriesNextServer = 2 
属性 中 设置 的 内 容 ， 在 出 现 失 败 时 ， 此 操作 将 重复 两 次 。 如 果 上 述 描述 的 机 制 最 终 不 成 
功 ， 则 会 因为 超时 而 返回 到 外 部 客户 站 。 在 这 种 情况 下 ， 即 使 超过 4 秒 钟 的 情况 也 可 能 
ribbon: 
eureka: 
enabled: true 
MaxAutoRetries: 1 
MaxAutoRetriesNextServer: 2 


ConnectTimeout: 500 
ReadTimeout: 1000 


feign: 
hystrix: 
enabled: false 

该 解决 方案 是 为 基于 微服 务 的 环境 实现 的 标准 重 试 机 制 。 开 发 人 员 还 可 以 了 解 一 些 
与 Ribbon 的 超时 和 重 试 的 不 同 配置 设置 相关 的 其 他 方案 。 上 所 以 再 要 将 这 种 机 制 与 Hystrix 
的 断路 器 一 起 使 用 。 但 是 ， 开 发 人 员 必 须 记 住 ，ribbon.ReadTimeout 属性 的 值 应 该 低 于 
Hystrix 的 execution.isolation.thread.timeoutInMilliseconds 属性 的 值 。 

建议 开发 人 员 测 试 上 述 配 置 设置 ， 并 把 它 作 为 一 项 练习 。 可 以 使 用 先前 介绍 的 
Hoverfly JUnit 规则 来 模拟 服务 实例 的 延迟 和 存根 。 


7.5.2 ”Hystrix 对 Feign 的 支持 
如 前 文 所 述 ， 在 使 用 Feign 库 时 ， 默 认 情 况 下 会 为 应 用 程序 启用 Hystrix， 但 这 仅 适 


用 于 旧版 本 的 Spring Cloud。 根 据 最 新 版 Spring Cloud 的 说 明文 档 ， 开 发 人 员 应 该 将 
feign.hystrix.enabled 属性 设置 为 ttue， 这 会 强制 Feign 用 断路 器 包 于 所 有 方法 。 
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(中 注意: 
在 Spring Cloud Dalston 发 布 之 前 , 如果 Hystrix 在 类 路 径 上 , 则 Feign 默认 会 将 所 有 方 
法 包 囊 在 断路 器 中 。 
在 Spring Cloud Dalston 版 本 中 更 改 了 此 默认 行为 ， 转 而 采用 了 选择 性 加 入 的 方法 。 


将 Hystrix 与 Feign 客户 端 一 起 使 用 时 ， 要 提供 以 前 在 @HystrizCommand 中 使 用 
@HystrixProperty 设置 的 配置 属性 ， 最 简单 的 方法 是 通过 application.yml 文件 。 以 下 是 之 
前 提供 的 示例 的 等 效 配 置 。 


hystrix: 
command: 
default: 
cIrcuitBreaker: 
requestVolumeThreshold: 10 
errorThresholdPercentage: 30 
sleepWindowInMilliseconds: 1l10000 
executlion: 
1solation: 
thread: 
timeoutInMilliseconds: 1l1000 
metrics: 
rollingstats: 
timeInMilliseconds: 10000 


Feign 支持 回 退 表示 法 。 要 为 给 定 的 @FeignClient 启用 回 退 机 制 ， 应 该 使 用 提供 回 退 
实现 的 类 名 设置 fallback 属性 。 该 实现 类 应 该 定义 为 Spring Bean。 


QFeignClient (name = "customer-service", fallback = 
CustomerClientFallback.class,) 
public interface CustomerClient | 


QCachePut ("customers") 

GetMapping("/withAccounts/{customerId}") 

Customer findByIdWithAccounts (QPpathVariable ("customerId") Long 
customerId); 


} 
回 退 实现 基于 缓存 ， 并 且 将 实现 使 用 @FeignClient 注解 的 接口 。 
QComponent 


public class CustomerClientFallback implements CustomerClient 1 
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Autowired 
CacheManager CacheManadeT:， 


aoOverride 
public Customer findByIdWithAccountsFallback (Long customerld) 1 
ValueWrapper Ww = 
cacheManager.getCache(" customers") .get (customerld}; 
if {Ww LI= null}) I 
return (Customer) w.get(); 
} else 1 
return new Customer (); 


} 


或 者 ， 也 可 以 考虑 实现 FallbackFactory 类 。 这 种 方法 有 一 个 很 大 的 优势 ， 它 使 开发 
人 员 可 以 访问 导致 回 退 触发 的 原因 。 要 为 Feign 声明 FallbackFactory 类 ， 只 需 使 用 
@FeignClient 中 的 fallbackFactory 属性 。 

QFeignClient (name = "account—service", fallbackFactory = 


AccountClientFallbackFactory.class) 
public interface AccountClient 1 


Cacheput 

GetMapping("/customer/{customerId}") 

List<Account> findByCustomer (QPathVariable ("customerId") Long 
customerId); 


} 


自 定 义 FallbackFactory 类 需要 实现 一 个 FallbackFactory 接口 ， 该 接口 将 声明 一 个 必 
顷 被 履 盖 的 Tecreate (Throwable cause) 方法 。 


QComponent 
Public class AccountClientFallbackFactory implements 
FallbackFactory<AccountClient> | 


@Autowired 
CacheManager cacheManager; 


ROverride 
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public AccountClient create (Throwable cause) 1 
return new AccountClient() 1 
QOverride 
List<Account> findByCustomer{(Long customerId) | 
ValueWrapper W = 
cacheManager.getCache ( -accounts ) .get (customerId}); 
if {(w I= null) 1{ 
return (List<Account>) w.get()}); 
} else | 
return new Customer ( ) ; 


} 


7.6 小 结 


如 果 开 发 人 员 包 使 用 上 自动 配置 的 客户 端 进行 服务 间 通 信 ， 则 可 能 不 了 解 本 章 中 介绍 
的 配置 设置 或 工具 。 但 是 ， 我 们 认为 开 上 友人 员 应 该 对 这 些 高 级 机 制 有 所 了 解 ， 即 使 它们 
可 以 在 后 台 运 行 或 有 现成 可 用 的 东西 。 本 章 尝 试 通过 一 些 简单 示例 演示 了 它们 的 工作 原 
理 ， 使 开发 人 员 可 以 更 详细 地 了 解 诸如 负载 均衡 器、 重 试 、 回 退 或 断路 圳 之 类 的 主题 。 
阅读 本 章 后 ， 开 发 人 员 应 该 能 够 自 定义 Ribbon、Hystrix 或 Feign 客户 端 ， 以 满足 与 微服 
务 之 间 的 通信 相关 的 需求 ， 无 论 是 小 规模 还 是 大 规模 需求 。 开 发 人 员 还 应 该 了 解 在 系统 
中 使 用 它们 的 时 间 和 原因 。 到 本 章 为 止 ， 基 于 微服 务 架 构 中 核心 元 素 的 讨论 就 到 此 结 
束 了 。 

接 下 来 ， 我 们 将 把 目光 放 到 系统 之 外 ， 讨 论 一 个 更 重要 的 组 件 : 网 天。 它 可 以 从 外 
部 客户 端 隐 栽 系统 的 复杂 性 。 
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本 章 将 讨论 基于 微服 务 架 构 的 下 一 个 重要 元 素 ， 即 API 网 关 (API Gateway) 。 这 不 
是 我 们 在 实践 中 第 一 次 遇 到 这 个 元 素 。 本 书 在 第 4 章 “ 服 务 发 现 ” 中 实现 了 一 个 简单 的 
网 关 模 式 ， 目 的 是 介绍 分 区 机 制 如 何在 使 用 Eureka 的 情况 下 进行 服务 发 现 。 我 们 还 曾经 
使 用 过 Netflix 的 Zuul 库 ， 它 是 一 个 基于 Java 虚拟 机 (Java Virtual Machine，JVM) 的 路 
由 器 和 服务 器 端 儿 载 均衡 器 。Netflix 设计 了 Zuul， 以 提供 号 份 验证 、 压 力 测试 和 人 金 丝 仪 
测试 (Canary Test) 、 动 态 路 由 ， 以 及 主动 流量 管理 /主动 多 区 域 流 量 管理 (Active 
Multiregional Traffic Management) 等 功能 。 虽 然 没 有 明确 说 明 ， 但 它 也 可 以 充当 微服 务 
架构 中 的 网 关 ， 其 主要 任务 是 从 外 部 客户 端 隐藏 系统 的 复杂 性 。 

事实 上， 到 目前 为 止 ，Zuul 在 Spring Cloud 框架 内 的 API 网 关 模 式 实 现 方面 没有 任 
何 竞争 对 手 。 但 是 ， 随 着 一 个 名 为 Spring Cloud Gateway 的 新 项 目的 逐步 发 展 ， 情 况 正 在 
发 生变 化 。 这 个 新 项 目 建 立 在 Spring Framework 5、Project Reactor 和 Spring Boot 2.0 的 基 
础 之 上 。 该 库 的 最 近 一 个 稳定 版 本 是 1.0.0, 但 目前 正在 开发 的 版 本 2.0.0 中 则 有 许多 重要 
的 变化 ， 它 仍然 处 于 里 程 碑 阶段 。Spring Cloud Gateway 上 在 提供 一 种 简单 而 有 效 的 方法 
来 路 由 API， 并 提供 与 其 相关 的 中 领域 问题 ， 如 安全 性 、 监 控 / 指 标 和 弹性 。 虽 然 该 解决 
方案 相对 较 新 ， 但 绝对 值得 关注 。 

本 章 将 要 讨论 的 主题 包括 : 

口 基于 URL 的 静态 路 由 和 负载 均衡 。 
将 Zuul 和 Spring Cloud Gateway 与 服务 发 现 集成 。 
使 用 Zuul 创建 自 定 义 过 滤器 。 
使 用 Zuul 目 定 义 路 由 配置 。 
在 路 由 失败 的 情况 下 提供 Hystrix 后 备 。 
对 Spring Cloud Gateway 中 包含 的 主要 组 件 一 一 谓词 和 网 关 过 滤器 的 说 明 。 


DLL DO LO 


8.1 使 用 Spring Cloud Netflix Zuul 


Spring Cloud 实现 了 一 个 仍 入 式 Zuul 代理 ， 人 允许 前 端 应 用 程序 对 后 端 服务 的 代理 调 
用 。 此 功能 对 外 部 客户 端 非常 有 用 ， 因 为 它 隐 减 了 系统 复杂 性 ， 有 助 于 避免 为 所有 微服 
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务 独立 管理 跨 源 资 源 共 享 (Cross-Origin Resource Sharing，CORS) 和 刁 份 验证 问题 。 要 
启用 它 ， 可 以 使 用 @EnableZuulProxy 注解 Spring Boot 的 main 类 ， 并 将 传 入 的 请 求 转发 
到 目标 服务 。 当 然 ，Zuul 也 可 以 与 Ribbon 负载 均衡 器 、Hystrix 断路 器 和 服务 发 现 (如 使 
用 Eureka) 集成 在 一 起 。 


8.1.1 构建 网 关 应 用 程 友 


现在 不 妨 先 回 到 第 7 章 中 的 示例 , 将 最 后 一 个 元 素 附 加 到 基于 微服 务 的 染 构 : API 网 
关中 。 我 们 尚未 考虑 的 是 外 部 客户 问 调 用 服务 的 方式 。 首 先 ， 我 们 不 希望 公开 系统 内 运 
行 的 所 有 微服 务 的 网 络 地 址 。 我 们 还 可 以 在 一 个 地 方 执行 茶 些 操作 ， 如 请 求 喘 份 验证 或 
设置 跟 踊 标 涉 。 对 于 上 述 问 题 的 解决 方案 是 仪 共 至 单个 边缘 网 络 地 址 ， 该 地 址 会 将 所 有 
传 入 请 求 代 理 到 适当 的 服务 。 当 前 示例 的 系统 染 构 如 图 8.1 所 示 。 


图 8.1 示例 系统 架构 


对 于 当前 示例 的 这 些 需求 ， 不 妨 回 过 头 来 参考 一 下 第 7 章 已 经 讨论 过 的 项 目 。 它 可 
以 在 GitHub 的 master 分 文 (https://github.com/piomin/sample-spring-cloud-comm.git) 中 找 
到 。 现 在 ， 我 们 将 为 该 项 目 添 加 一 个 名 为 gateway-service 的 新 模块 。 第 一 步 就 是 将 Zuul 
包含 在 Maven 依赖 项 中 ， 这 里 必须 使 用 spring-cloud-starter-zuul 启动 器 。 
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<dependency> 
<OroupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-zuul</artifactId> 
</dependency> 


在 使 用 @EnableZuulProxy 注解 Spring Boot 主 类 之 后 ， 可 以 继续 进行 路 由 配置 ， 该 配 
置 在 application.yml 文件 中 提供 。 默 认 情 况 下 ，Zuul 局 动工 件 不 包括 服务 发 现 客户 疹 。 路 
由 是 静态 配置 的 ，url 属性 将 被 设置 为 服务 的 网 络 地 址 。 现 在 ， 如 果 局 动 所 有 微服 务 和 网 关 
应 用 程序 ， 则 可 以 尝试 通过 网 关 调 用 它们 。 每 个 服务 在 每 个 路 由 的 配置 属性 path 中 设置 的 
路 径 下 可 用 ， 如 http:wlocalhost:8080/account/1 地 址 将 被 转发 到 http://localhost:8091/1。 

port: 5S5{PORT:8080] 


zuUuul: 
routes: 
account: 
path: /account/** 
url: http://localhost:8091 
customer: 
path: /customer/** 
url: http://localhost:8092 
Brer = 
path: /order/** 
url: http://localhost:8090 
product: 
path: /product/** 
Url1: http://localhost:8093 


8.1.2 与 服务 发 现 集成 


上 一 个 示例 中 提供 的 静态 路 由 配置 对 于 基于 微服 务 的 系统 来 说 是 不 够 的 。API 网 关 
的 主要 需求 是 与 服务 发 现 的 内 置 集成 。 要 为 Zuul 启用 在 使 用 Eureka 情况 下 的 服务 发 现 ， 
开发 人 员 必 须 在 项 目 依 赖 项 中 包含 spring-cloud-starter-eureka 启动 器 ， 并 通过 
@EnableDiscoveryClient 来 注解 应 用 程序 的 main 类 ， 然 后 再 启用 客户 端 。 实 际 上 ， 让 网 
关 在 发 现 服务 器 中 注册 它 自 己 是 没有 意义 的 ， 它 必须 仅 获取 注册 服务 的 当前 列表 。 因 此 ， 
开发 人 员 可 以 将 eureka.client.registerWithEureka 属性 设置 为 false， 以 这 种 方式 来 禁用 该 
注册 。 至 于 application.yml 文件 中 的 路 由 定义 则 非常 简单 。 每 个 路 由 的 名 称 都 将 映射 到 
Eureka 中 的 应 用 程序 服务 名 称 。 


2 


ZUUJ : 
TOULes> 
Account—-service: 
path: /account/** 
customer-service: 
path: /customer/** 
Drder ServVIiCe. 
path: /order/** 
Produnct— service: 
path: /product/** 


8.1.3” 自 定义 路 由 配置 


有 硅 干 个 配置 设置 均 允 许 开发 人 员 自 定义 Zuul 代理 的 行为 。 其 中 一 些 与 服务 发 现 集 
成 有 非常 密切 的 关联 。 

1. 忽略 已 注册 的 服务 

姑 认 情况 下 ，Spring Cloud Zuul 会 公开 在 Eureka 服务 器 中 注册 的 所 有 服务 。 如 果 要 
跳 过 日 动 添加 每 项 服务 ， 则 必须 使 用 与 发 现 服务 器 中 所 有 被 忽略 的 服务 名 称 相 匹配 的 模 
式 设置 zuul.ignored-services 属性 。 那 么 它 在 实践 中 是 如 何 运 作 的 呢 ? 即 使 开发 人 员 没 有 
使 用 zuul.routes.* 属 性 提供 任何 配置 ，Zuul 也 会 从 Eureka 获取 服务 列表 并 目 动 将 它们 绑 
定 到 具有 服务 名 称 的 路 径 上 。 例 如 ,account-service 服务 将 在 网 关 地 址 http://localhost:8080/ 
account-service/** 下 可 用 。 现 在 ， 如 果 在 application.yml 文件 中 设置 以 下 配置 ， 那 么 它 将 
忽略 account-service 服务 并 以 HTTP 404 状态 啊 应 。 


过 本 可 : 
ignoredServices: “account 一 SeTVLCe- 


也 可 以 通过 将 zuulignored-services 设置 为 *' 来 忽略 所 有 已 注册 的 服务 。 如 果 某 服务 
匹配 了 被 忽略 的 模式 ， 但 和 它 也 包含 在 路 由 映射 配置 中 ， 那 么 它 将 包含 在 Zuul 中 。 例 如 ， 
在 以 下 情况 下 ， 将 仅 处 理 customer-service 服务 。 

ZUUJ : 

TNOoOredServices, 7 


TOULES : 
cuStomer—service: /customer/** 


2. 明确 设置 服务 名 称 
开发 人 员 还 可 以 使 用 serviceld 属性 在 配置 中 设置 发 现 服务 器 的 服务 名 称 。 这 种 方式 
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可 以 提供 对 路 径 的 细 粒 度 控 制 ， 因 为 这 样 意 味 着 可 以 单独 指定 路 径 和 serviceId。 以 下 是 
路 由 的 等 效 配置 。 


ZUUJ : 
routes: 
accounts: 
path: /account/** 
serviceld: account-service 
customers: 
path: /customer/** 
servicelId: customer-service 
orders: 
path: /order/** 
Serviceld: order-service 
products: 
path: /product/** 
Serviceld: product—service 


3. 使 用 Ribbon 香 户 闯 进 行路 由 定义 
还 有 男 一 种 配置 路 由 的 方法 。 开 友人 员 可 能 会 禁用 Eureka 上 友 现 ， 以 便 仅 依赖 Ribbon 
客户 端的 listOfServers 属性 提供 的 网 络 地 址 列表 。 默 认 情况 下 ， 可 以 通过 Ribbon 客户 端 
在 所 有 服务 实例 之 间 对 网 关 的 所 有 传 入 请 求 进行 负载 均衡 。 即 使 局 用 或 禁用 服务 发 现 ， 
此 规则 也 适用 ， 示 例 代 码 如 下 。 
ZUUJ : 
routes: 
accounts: 
path: /account/** 
serviceld: account-service 


ribbon: 
eureka: 
enabled: false 


account—-service: 
ribbon: 
listofServers: http://localhost:8091,http://localhost: 9091 


4. 在 路 径 中 添加 表 缀 
有 时 需要 为 通过 网 关 调 用 的 服务 设 曾 不 同 的 路 径 ， 而 不 是 允许 它们 直接 可 用 。 在 这 
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种 情况 下 ，Zuul 提供 了 为 所 有 定义 的 映射 添加 前 绥 的 功能 。 这 可 以 使 用 zuul.prefix 属性 
轻松 配置 。 默 认 情 况 下 ，Zuul 会 在 将 请 求 转发 给 服务 之 前 去 挥 该 前 级 。 

但 是 ， 也 可 以 通过 将 zuul.stripPrefix 属性 设置 为 false 来 禁用 该 行为 。stripPrefix 属性 
不 仅 可 以 为 所 有 已 定义 的 路 由 全 局 配置 ， 还 可 以 为 每 个 路 由 配置 。 

以 下 就 是 一 个 为 所 有 转发 的 请 求 添加 /api 前 级 的 示例 。 举 例 来 说 ， 现 在 开发 人 员 如 
果 想 调用 account-service 服务 的 GET /id} 靖 点 ， 则 应 该 使 用 的 地 址 是 http://localhost: 
8080/aplaccount/ 1] 。 

zuUul: 

prefix: /api 
routes: 
accounts: 
path: /account/** 
Serviceld: account—service 
customers: 
path: /customer/** 
serviceld: customer ServicCe 

如 果 此 时 提供 了 将 stripPrefix 属性 设置 为 false 的 配置 ， 会 出 现 什么 问题 呢 ? 在 这 种 
情况 下 ，Zuul 会 尝试 在 上 下 文 路 径 /api/account 和 /apicustomer 下 查找 目标 服务 中 的 端点 。 

ZUUJ : 

PreFEix: Kap 
stripPrefix: Talse 


5. 连接 设置 和 超时 

Spring Cloud Netflix Zuul 的 主要 任务 是 将 传 入 请 求 路 由 到 下 游 服务 。 因 此 , 它 必 须 使 
用 HTTP 客户 端 实现 来 与 这 些 服务 进行 通信 。Zuul 使 用 的 默认 HTTP 客户 端 现在 由 Apache 
HTTP Client 文 持 ， 而 不 是 已 经 不 推荐 使 用 的 Ribbon RestClient。 如 果 要 使 用 Ribbon， 则 
应 该 将 ribbon.restclient.enabled 的 属性 设置 为 true。 或 者 也 可 以 通过 将 Tribbon.okhttp.enabled 
属性 设置 为 true 来 尝试 OkHttpClient。 

开发 人 员 可 以 配置 HTTP 客户 端的 基本 设置 ， 如 连接 或 读 取 超时 ， 以 及 最 大 连接 数 。 
根据 是 否 使 用 了 服务 发 现 ， 此 类 配置 有 两 个 可 用 选项 。 如 果 已 通过 url 属性 定义 了 有 具有 指 
定 网 络 地 址 的 Zuul 路 由 ， 则 应 设置 zuul.host.connect-timeout-millis 和 zuul.host.socket- 
timeout-millis。 为 了 控制 最 大 连接 数 ， 开 发 人 员 应 该 履 新 zuul.host.maxTotalConnections 属 
性 的 默认 值 ， 该 属性 的 默认 设置 为 200。 还 可 以 通过 设置 zuul.host.maxPerRouteConnections 
属性 定义 每 个 路 由 的 最 大 连接 数 ， 该 属性 的 默认 值 为 20。 
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如 果 Zuul 已 经 被 配置 为 从 发 现 服务 器 获取 服务 列表 , 则 需要 使 用 Ribbon 客户 端 属性 
ribbon.ReadTimeout 和 ribbon.SocketTimeout 配置 与 以 前 相同 的 超时 值 。 还 可 以 使 用 
ribbon.MaxTotalConnections 和 ribbon.MaxConnectionsPerHost 属性 目 定 义 最 大 连接 数 。 

6. 保护 标 头 的 安全 

如 果 在 请 求 中 已 经 设置 了 诸如 Authorization 之 类 的 HTTP 标 头 ， 但 是 它 未 被 转发 到 
下 游 服务 ， 你 是 否 会 感到 有 些 疑 惑 ? 其 实 这 是 因为 Zuul 定义 了 敏感 标 头 的 默认 列表 ， 这 
些 标 头 在 路 由 过 程 中 将 被 删除 。 这 个 默认 列表 中 的 标 头 包括 Cookie、Set-Cookie 和 
Authorization。 此 功能 是 站 在 与 外 部 服务 器 进行 通信 的 角度 进行 设计 的 。 虽 然 不 反对 在 同 
一 系统 中 的 服务 之 间 共 享 标 涉 ， 但 出 于 安全 原因 ， 不 建议 与 外 部 服务 器 共享 标 头 。 如 果 
有 必要 ， 可 以 通过 和 窗 新 sensitiveHeaders 属性 的 默认 值 来 日 定义 此 方法 。 它 可 以 为 所 有 路 
由 全 局 设置 ， 也 可 以 仅 针 对 单个 路 由 设置 。sensitiveHeaders 不 是 一 个 空 的 黑 名 单 ， 所 以 ， 
要 让 Zuul 转发 所 有 标 头 ， 则 应 该 明确 地 将 它 设置 为 空 列 表 。 

a EO 

routes: 

accounts: 
path: /account/** 
sensitiveHeaders: 
SeErviceId: account-service 


8.1.4 ”管理 端点 


Spring Cloud Netflix Zuul 公开 了 两 个 额外 的 管理 端点 用 于 监控 。 

口 Routes (路 由 ) : 打印 已 经 定义 的 路 由 的 列表 。 

口 Filters (过 滤器) : 打印 已 经 实现 的 过 滤器 的 列表 (可 以 从 Spring Cloud Netflix 

的 1.4.0 版 本 获得 ) 。 

要 局 用 管理 端点 功能 ， 必 须 在 项 目 依 赖 项 中 包含 spring-boot-starter-actuator， 这 和 前 
文 介 绍 的 方法 是 一 样 的 。 另 外 ， 考 虑 到 测试 需要 ， 最 好 能 禁用 痛 点 安全 性 设置 ， 方 法 是 
将 management.security.enabled 属性 设置 为 false。 现 在 可 以 调用 GET /routes 方法 ， 它 将 
为 我 们 的 示例 系统 打印 以 下 JSON 啊 应 。 

"api/account/**": Vaccount—-service”™, 


"/api/customer/**": "customer-service", 
"Japi/order/**": Vorder-service™, 
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"fapi/product/**™": "product—service"™, 


} 


要 获得 更 多 详细 人 信息， 必须 将 ?format=details 查询 字符 串 添加 到 /routes 路 径 。 该 选项 
在 Spring Cloud 1.4.0 版 ‘(Edgware 版 本 列车 ) 中 也 可 以 使 用 。 还 有 一 种 POST /route 方法 
会 强制 刷新 当前 存在 的 路 由 。 上 此外， 也 可 以 通过 将 endpoints.routes.enabled 设置 为 false 
来 禁用 整个 端点 。 


"api/accounty**™- | 
A 
"fullpath": /api/jaccount/*#*™ 
"location”: "account—service", 
"path™: m/w 
"prefix": "/api/account™, 
人 
"customSensitiveHeaders": false, 
"prefixstripped”: true 

} 


/filters 端点 的 啊 应 结果 非常 有 趣 。 开 发 人 员 可 以 在 Zuul 网 关上 查看 默认 情况 下 可 用 
的 过 滤器 数量 和 类 型 。 以 下 就 是 使 用 一 个 选 定 过 滤器 的 啊 应 片段 。 它 包含 完整 的 类 名 、 
调用 顺序 和 状态 。 有 关 过 滤器 的 更 多 信息 ， 请 参阅 本 章 第 8.1.6 节 “Zuul 过 滤器 ”。 
"route™: [1 
ss 
"org.springframework.cloud.netflix.zuul .fijlters.route.RibbonRoutingFilter", 
"order"”: 10., 
"disabled": false, 
“latacC = Ere 
}, {1 
] 


8.1.5 提供 Hystrix 回 退 bean 


开发 人 员 可 能 需要 为 Zuul 配置 中 定义 的 每 个 路 由 提供 在 电路 断 开 情形 下 的 回 退 啊 
应 。 要 完成 此 任务 ， 应 该 创建 一 个 ZuulFallbackProvider (目前 已 弃 用 ) 类 型 的 bean 或 
FallbackProvider。 在 该 实现 中 , 必须 指定 路 由 ID 模式 以 匹配 应 该 由 回 退 bean 处 理 的 所 有 
路 由 。 第 二 步 则 是 返回 ClientHttpResponse 接口 的 实现 作为 fallbackResponse 方法 中 的 
啊 应 。 
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以 下 就 是 一 个 简单 的 回 退 bean 示例 , 它 将 每 个 异常 映射 到 HITP 状态 200 OK, 并 在 
JSON 啊 应 中 设置 errorCode 和 errorMessage。 该 回 退 将 仅 对 account-service 服务 的 路 由 
执行 。 


public class AccountFallbackProvider implements FallbackProvider | 


Override 
public String getRoute() I 
return "account—service”™s? 


Override 
public ClientHttpResponse fallbackResponse (Throwable cause}) | 
return new ClientHttpResponse() 1 


QOverride 

public HttpHeaders getHeaders() | 
HttpHeaders headers = new HttpHeaders ():; 
headers.setContentType (MediaType.APPLICATION JSON); 


return headers: 


QOverride 
public Inputstream getBody{} throws IOException 1 
AccountrFallbackResponse response = new 
AccountFallbackResponsel("l.2", cause .GetMessage() ) :; 
return new ByteArrayInputstream (new 
ObjectMapper() .writeValueAsBytes (response)}));? 
} 


QOverride 
public String getSstatusText() throws IOException 1 
return "OFR™; 


QOverride 
public HPStatus getSstatusCode() throws IOException | 
return Httpstatus .OFR; 


QOverride 
Public int gqetRawSstatusCode(} throws IOException 1 
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return 200; 


} 


QOverride 
Public Vold closel() 1 


8.1.6 ”Zuu|l 过 滤器 


如 前 文 所 述 ，Spring Cloud Zuul 默认 提供 了 知 干 个 bean， 它 们 是 ZuulFilter 接口 的 实 
现 。 通 过 将 zuul.<SimpleClassName>.<filterType>.disable 属性 设置 为 tue， 可 以 禁用 每 个 内 
置 过 滤器 。 例 如 ， 要 禁用 org.springframework.cloud netflix.zuul.filters.postSendResponseFilter， 
束 必 须 设 曾 zuul.SendResponse Filter.post.disable=true。 
开发 人 员 对 HTTP 过 滤 机 制 可 能 会 很 熟悉 。 过 滤器 将 动态 拦截 请 求 和 响应 ， 以 转换 
或 仅 使 用 从 HTTP 消息 中 获取 的 信息 。 它 可 以 在 传 入 请 求 或 传 出 啊 应 之 前 或 之 后 触发 。 
我 们 可 以 确定 Zuul 为 Spring Cloud 提供 的 以 下 几 种 类 型 的 过 滤器 。 
口 ” 预 人 处理 过 滤器 (Pre Filter) : 用 于 在 RequestContext 中 准备 初始 数据 ， 以 便 在 下 
游 过 滤器 中 使 用 。 主 要 职责 是 设置 路 由 过 滤器 所 需 的 信息 。 
口 ”路 由 过 滤器 (Route Filter) : 在 预 过 滤器 之 后 调用 ,负责 创建 对 其 他 服务 的 请 求 。 
使 用 它 的 主要 原因 是 需要 使 请 pe 理应 客户 端 所 需 的 模型 。 
口 ”后 处 理 过 滤器 (Post Filter) : 最 为 第 见 ， 它 将 操纵 啊 应 ， 甚 至 可 能 转换 啊 应 的 
正 访 
口 ”错误 过 滤 费 (Error Filter) : 仅 在 其 他 过 滤器 抛 出 异常 时 执行 。 它 只 有 一 个 内 置 
的 错误 过 波 问 实现 。 如 果 RequestContext.getThrowableO 不 为 null， 则 执行 
SendErrorFilter。 


， 预 定义 的 过 才 滤 器 


如 果 使 用 @EnableZuulProxy 注解 main 类 ， 则 Spring Cloud Zuul 会 加 载 
SimpleRouteLocator 和 DiscoveryClientRouteLocator 使 用 的 过 滤 占 bean。 以 下 是 作为 普通 
Spring bean 安装 的 最 重要 实现 的 列表 。 
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口 ServletDetectionFilter: 这 是 一 个 预 处 理 过 波 占 。 它 将 检查 请 求 是 否 通 过 Spring 
Dispatcher ， 然 后 它 会 使 用 FilterConstants.IS DISPATCHER SERVLET 
REQUEST KEY 键 设 置 a 尔 值 。 


口 FormBodyWrirapperFilter: 这 是 一 个 预 处 理 过 滤器 。 它 将 解析 表单 数据 并 为 下 游 
请 求 重 新 编码 。 


口 “PreDecorationFilter: 这 是 一 个 预 处理 过 滤器 。 它 将 根据 提供 的 RouteLocator 确 
定 路 由 的 位 置 和 方式 。 它 还 负责 设置 与 代理 相关 的 标 头 。 

口 “SendForwardFilter: 这 是 一 个 路 由 过 滤器 。 它 将 使 用 RequestDispatcher 转发 请 求 。 

口 RibbonRoutingFilter: 这 是 一 个 路 由 过 滤器 。 它 将 使 用 Ribbon、Hystrix 和 外 部 
HTTP 客户 端 (如 Apache HttpClient、OkHttpClient 或 Ribbon HTTP 客户 端 ) 发 
送 请 求 。 服 务 ID 取 目 请 求 上 下 文 。 

口 SimpleHostRoutingFilter: 这 是 一 个 路 由 过 滤器 。 它 通过 Apache HTTP 客户 端 发 
送 请 求 到 URL。URL 位 于 请 求 上 下 文中 。 

口 ”SendResponseFilter: 这 是 一 个 后 处 理 过 滤器 。 它 会 将 代理 请 求 的 啊 应 写 入 当前 
9 MY。 


2. 自 定义 过 二 滤器 实现 


除了 默认 安装 的 过 滤器 之 外 ， 开 发 人 员 还 可 以 创建 日 定 义 实现 。 每 个 目 定 义 的 过 渡 
器 都 必须 实现 ZuulFilter 接口 及 其 4 种 方法 .这 些 方法 负责 设置 过 滤器 的 类 型 (filterType)、 
确定 具有 相同 类 型 的 其 他 过 滤 之 间 的 过 滤器 执行 顺序 (filterOrder) 、 局 用 或 禁用 过 滤器 
(shouldFilter) 以 及 过 滤器 逻辑 实现 (run) 。 以 下 就 是 一 个 将 X-Response-ID 标 头 添加 
到 啊 应 的 示例 实现 。 


Public class AddResponselDHeaderFilter extends zuulFilter 1 
private jint id = 1; 


aoOverride 
public String filterTypel() 1 
TETrTn “Post 3 


} 


QOverride 
public int filterorder() I 
return 10; 


} 
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aoOverride 
Public boolean shouldFilter() 1 
return true; 
} 
Override 
Public Obiject Tan 1 
RequestContext context = RequestContext .getCurrentContext (}; 
HttpservletResponse servletResponse = Context .getResponse(); 
ServletResponse.addHeader ("XX-Response-—ID", 
String-valyueof (1d+t+}}s 
return null; 
} 
} 
这 并 不 是 全 部 。 事实 上 , 目 定 义 过 滤 副 实现 也 应 该 在 main 类 或 Spring 配置 类 中 声明 
为 @Bean。 
QBean 


AddResponselIDHeaderFilter filter() I 


} 


return new AddResponselDHeaderFilter (); 


8.2 使 用 Spring Cloud Gateway 


Spring Cloud Gateway 有 以 下 3 个 基本 概念 。 


UU 


UD 


路 由 (Route): 这 是 网 天 的 基本 构建 块 。 它 由 用 于 标识 路 由 的 唯一 ID、 目 标 
URI、 谓 词 列 表 和 过 滤器 列表 组 成 。 仅 当 已 满足 所 有 谓词 时 才 匹 配 路 径 。 

谓词 〈Predicate) : 这 些 是 在 处 理 每 个 请 求 之 前 执行 的 迎 辑 。 它 负责 检测 HITP 
请 求 的 不 同属 性 〈 如 标 头 和 参数 ) 是 否 与 定义 的 标准 匹配 。 该 实现 基于 Java 8 接口 
java.util.function.Predicate <T> 。 其 输入 类 型 则 依次 基于 Spring 的 org.springframework. 
Web.seIVeI.SeIVeIWebExchange。 

过 滤器 〈Filter) : 它们 允许 修改 传 入 的 HITP 请 求 或 传 出 的 HITP 响应 。 可 以 
在 发 送 下 游 请 求 之 前 或 之 后 修改 它们 。 路 入 过 滤器 的 范围 限定 为 特定 路 入 。 它 
们 实现 了 Spring 的 org.springeframework.web.server.GatewayFilter。 
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8.2.1 为 项 目 启 用 Spring Cloud Gateway 


Spring Cloud Gateway 构建 于 Netty Web 容器 和 Reactor 框架 之 上 。Reactor 项 目 和 
Spring Web Flux 可 以 与 Spring Boot 2.0 版 一 起 使 用 。 到 目前 为 止 ， 我 们 使 用 的 都 是 1.5 
版 , 因此 父 项 目 版 本 的 声明 不 同 。 目前 , Spring Boot 2.0 仍 处 于 里 程 碑 阶段 。 以 下 是 Maven 
的 pom.xml 中 的 片段 ， 它 继承 日 spring-boot-starter-parent 项 目 。 


<parent> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-parent</artifactId> 
<Version>2.0.0.Mi</version> 

</parent> 


与 前 面 的 示例 相 比 ， 我 们 还 需要 更 改 Spring Cloud 的 版 本 列车 。 最 新 的 里 程 碑 版 本 
是 Finchley.M5。 


<properties> 
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> 
<java.version>1.8</jJava.version> 
<spring-cloud.version>Finchley.M5</spring—-cloud.version> 
</properties> 
<dependencyManagement> 
<dependencies> 
<dependency> 
<qroupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-dependencies</artifactId> 
<version>${spring-cloud.version}</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


在 设置 了 正确 版 本 的 Spring Boot 和 Spring Cloud 之 后 ， 最 终 才 可 能 在 项 目 依 赖 项 中 
包含 spring-cloud-starter-gateway 局 动 器 。 
<dependency> 
<OroupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-gqateway</artifactId> 
</dependency> 
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8.2.2 ”内 置 请 词 和 过 滤器 


Spiing Cloud Gateway 包括 许多 内 置 路 由 谓词 (Route Predicate〉 和 网 关 过 滤器 工厂 
(Gateway Filter Factory) 。 可 以 使 用 application.yml 文件 中 的 配置 属性 或 使 用 Fluent Java 
Routes API 以 编程 方式 定义 每 个 路 由 。 表 8.1 就 是 其 可 用 谓词 工厂 列表 。 可 以 将 多 个 工厂 
组 合 为 具有 逻辑 与 (and) 关系 的 单个 路 由 定义 。 在 application.yml 文件 中 , 通过 spring.cloud. 
gateway.routes 属性 下 已 定义 的 每 个 路 由 的 predicates 属性 可 以 配置 过 渡 器 集合。 


名 称 


After Route 


Before Route 


Between Route 


Cookie Route 


Header Route 


Host Route 


Method Route 
Path Route 


Query Route 


RemoteAddr Route 


表 8.1 可 用 谓词 工厂 列表 


说 有 明 
它 需 要 一 个 日 期 时 间 参 数 并 匹配 在 它 之 后 
发 生 的 请 求 
它 需 要 一 个 日 期 时 间 参 数 并 匹配 在 它 之 前 
发 生 的 请 求 
它 需 要 两 个 日 期 时 间 参 数 ， 并 匹配 在 这 些 
日 期 之 间 发 生 的 请 求 
它 采用 cookie 名 称 和 正则 表达 式 参 数 ， 在 
HTTP 请 求 的 标 头 中 得 找 cookie， 并 将 其 
值 与 提供 的 表达 式 匹 配 
它 采 用 标 头 名 称 和 正则 表达 式 参数 ， 在 
HTTP 请 求 的 标 头 中 得 找 特 定 标 头 ， 并 将 
其 值 与 提供 的 表达 式 匹配 
它 采 用 一 个 具有 .分 隔 符 主机 名 ANT 样式 
的 模式 作为 参数 , 并 将 其 与 Host 标 头 匹配 
它 需 要 HITP 方法 作为 参数 进行 匹配 


它 采 用 请 求 上 下 文 路 径 的 模式 作为 参数 


它 需 要 两 个 参数 。 一 个 必需 的 参数 和 一 个 
可 选 的 正则 表达 式 ， 并 将 它们 与 得 询 参 数 
相 匹配 


它 采 用 CIDR 表示 法 中 的 卫 地 址 列表 , 如 
192.168.0.1/16， 并 将 其 与 请 求 的 远程 地 址 
进行 匹配 


示 _ 例 


Atter=2017-11-20T... 


Before=2017-11-20T... 


Between—=2017-11-20T1..., 2017-11-211... 


Cookie=SessionID. abc. 


Header=X-Request-Id. \d+ 


Host=**.example.org 


Method=GET 
Path=/account/ {1d} 


Query=accountId, 1. 


RemoteAddr=192.168.0.1/16 


网 关 过 滤器 模式 也 有 一 些 内 置 实现 。 表 8.2 提供 了 其 可 用 工厂 列表 。 在 application.yml 
文件 中 , 通过 spring.cloud.gateway.routes 属性 下 定义 的 每 个 路 由 的 filters 属性 可 以 配置 过 


滤器 集合 。 


名 称 


AddRequestHeader 


AddRequestParameter 


AddResponseHeader 


Hystrix 


PrefixPath 


RequestRateLimiter 


RedirectTo 


RemoveNonProxyHeaders 


RemoveRequestHeader 


RemoveResponseHeader 


RewritePath 
SecureHeaders 


SetPath 


SetResponseHeader 


Setstatus 
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表 8.2 可 用 过 滤器 工厂 列表 


在 HITP 请 求 中 添加 标 涉 ， 并 且 
使 用 在 参数 中 提供 的 名 称 和 值 

在 HITP 请 求 中 添加 查询 参数 ， 并 
且 使 用 在 参数 中 提供 的 名 称 和 值 
在 HTTP 啊 应 中 添加 标 头 ， 并 且 
使 用 在 参数 中 提供 的 名 称 和 值 

它 采 用 一 个 参数 ， 这 个 参数 就 是 
HystrixCommand 的 名 称 

为 参数 中 定义 的 HITP 请 求 路 径 
添加 前 缀 

它 将 根据 3 个 输入 参数 限制 每 个 
用 户 的 处 理 请 求 数 。 这 3 个 参数 
包括 : 每 秒 最 大 请 求 数 、 突 发 容 
量 和 返回 用 户 密 钥 的 bean 

它 将 HTTP 状态 和 重 定 同 URL 作 
为 参数 ， 并 将 其 放 入 Location 
HTTP 标 头 以 执行 重 定 向 

它 将 从 转发 的 请 求 中 删除 一 些 逐 
跳 (hop-by-hop) 标 头 ， 如 Keep- 
Alive、Proxy-Authenticate 或 Proxy- 
Authorization 

它 采 用 标 头 的 名 称 作 为 参数 ， 并 
将 其 从 HITP 请 求 中 删除 

它 采 用 标 头 的 名 称 作 为 参数 ， 并 
将 其 从 HTTP 响应 中 删除 

它 采 用 路 径 regexp 参数 和 替换 参 
数 ， 然 后 将 重 写 请 求 的 路 径 

它 可 以 给 啊 应 添加 一 些 安全 标 头 
它 采 用 带 有 路 径 模板 参数 的 单一 
参数 ， 并 且 将 更 改 请 求 路 径 
它 将 采用 名 称 和 值 参 数 来 设置 
HTTP 响应 的 标 头 

它 将 采用 一 个 状态 参数 ， 该 参数 
必须 是 有 效 的 HTTP 状态 ， 然 后 
将 其 设置 在 啊 应 上 


示 例 
AddRequestHeader 一 X-Response-ID, 123 
AddRequestParameter=1d, 123 
AddResponseHeaderX-Response-ID, 123 
Hystrix=account-service 


PreftixPath=/api 


RequestRateLimiter=10.20, #{((DuserKeyResolver} 


RedirectIo=302. http://localhost:8092 


RemoveRequestHeaderX-Request-Foo 


RemoveResponseHeader=X-Response-ID 


RewritePath=/account/(?<path>.*). /$\{path} 


SetPath=/ {seement} 


SetResponseHeader—X-Response-ID, 123 


setSstatus=401 
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以 下 是 一 个 简单 的 示例 ， 其 中 包含 两 个 谓词 和 两 个 过 滤 峰 集合 。 每 次 GET /account / 
fid} 请求 进 入 网 关 时 都 将 转发 到 http://localhost:8080/api/account/ {id}， 其 中 包含 新 的 
HTTP 标 头 X-Request-ID 。 


SPT1InG: 
cloud: 
gateway: 
OUIteS: 
- id: example route 
uri: http://localhost:8080 
predicates: 
- Method=GET 
— Path=/account/t{id} 
Fe 
- AddRequestHeader=X-Request—ID, 123 
—- Prefixpath=/api 


可 以 使 用 Route 类 中 定义 的 Fluent API 提供 相同 的 配置 ,这 种 风格 给 了 开发 人 员 更 大 
的 灵活 性 。 虽然 通 过 YAML 进行 配置 可 以 使 用 逻辑 与 (and) 组 合 谓词 ,但 是 Fluent Java 
API 人 允许 开发 人 员 在 Predicate 类 上 使 用 and0、or0 和 negateO 运 算 符 。 以 下 是 使 用 Fluent 
API 实现 的 蔡 代 路 由 。 


QBean 
public RouteLocator customRouteLocator (RouteLocatorBuilder routeBuilder) 


{ 
return routeBuilder.routes'() 

.TOUte ( ->r.method(HttpMethod.GET) .and() .path ("/account/{id}") 
.addRequestHeader ("XxX-Regquest-ID™", "123") .prefixPpath("/api") 
.Uri("http://localhost:8080")}) 

-Bulldelrs 

} 


8.2.3 ”做 服务 的 网 天 


现在 不 妨 回 到 之 前 的 基于 微服 务 的 系统 的 示例 , 这 是 本 章 在 基于 Spring Cloud Netflix 
Zuul 的 API 网 关 配 置 内 容 中 讨论 过 的 例子 。 我 们 希望 为 应 用 程序 准备 静态 路 由 定义 ， 并 
且 该 定义 与 基于 Zuul 代理 准备 的 相同 。 然后 , 每 个 服务 将 在 网 基地 址 和 特定 路 径 下 可 用 ， 
如 http://localhost:8080/account/**。 使 用 Spring Cloud Gateway 声明 此 类 配置 的 最 合适 方 
式 是 通过 Path Route Predicate Factory 和 RewritePath GatewayFilter Factory。 重 写 路 径 机 制 
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将 通过 参与 或 添加 一 些 模式 来 更 改 请 求 路 径 。 在 我 们 的 示例 中 ， 每 个 传 入 的 请 求 路 径 都 
将 从 account123 重 写 为 /123。 以 下 是 该 网 关 的 application.yml 文件 。 


Server: 
port: $5{PORT:8080} 


Spring: 
application: 
name: gateway—Service 
cloud: 
dateway: 
routes: 
— 1d: account— service 
uri: http://localhost:8091 
predicates: 
一 Path=/account/** 
filters: 
- RewritePath=/ accounty/ (?<path>.*), /$s$\{path} 
=- 1d: customer—Service 
uri: http://localhost:8092 
predicates: 
—- Path=/customer/** 
filters: 
- RewritePpath=/customer/ (?<path>.*), /s$\{path} 
eT. Ti 
uri: http://localhost:8090 
predicates: 
一 Path=/order/** 
filters: 
- RewritePath=/order/ (?<path>.*), /S$\{path} 
一 id: product— service 
uri: http://liocalhost:8093 
Bredicatess 
- Path=/product/** 
fjlters: 
- RewritePath=/product/ (?<path>.*), /$s$\{path)} 


令 人 惊讶 的 是 ， 这 就 是 本 示例 必须 要 做 的 一 切 。 与 我 们 在 使 用 其 他 Spring Cloud 组 
件 〈 如 Eureka 或 Config Server) 时 所 做 的 相 比 ， 在 这 里 不 必 提 供 任 何其 他 注解 。 因 此 ， 
我 们 的 网 关 应 用 程序 的 main 类 将 如 以 下 代码 所 示 。 必 须 使 用 mvn clean install 构建 项 目 并 
使 用 java -jar 局 动 它 ， 或 者 也 可 以 从 集成 开发 环境 运行 main 类 。 本 示例 应 用 程序 的 源 代 
码 可 在 GitHub (https://github.comy/piomin/sample-spring-cloud-gateway.git) 上 获得 。 
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QSpringBootApplication 
Public class GatewayApplication 1 


public static Vold main(string[] args) 1 
SpIringApplication.run(GatewayApplication.class, args); 


8.2.4 与 服务 发 现 集成 


网 天 可 以 被 配置 为 基于 在 服务 发 现 中 注册 的 服务 列表 来 创建 路 由 。 它 可 以 与 有 具有 
DiscoveryClient 兼容 服务 注册 表 的 解决 方案 集成 , 如 Netflix Eureka、Consul 或 Zookeeper。 
要 启用 DiscoveryClient 路 由 定义 定位 器 ， 应 将 spring.cloud.gateway.discovery.locator. 
enabled 属性 设置 为 tue， 并 在 类 路 径 上 提供 DiscoveryClient 实现 。 开 发 人 员 可 以 使 用 
Eureka 客户 端 和 服务 器 进行 发 现 。 请 注意 ， 要 使 用 Spring Cloud 的 最 新 里 程 碑 版 本 
FinchleyMS， 在 该 版 本 中 ， 所 有 Netflix 的 工件 名 称 都 已 更 改 ， 例 如 ， 现 在 spring-cloud- 


starter-eureka 已经 被 修改 为 spring-cloud-starter- netflix-eureka-client。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-netflix-eureka—client</artifactId> 
</dependency> 


Eureka 客户 并 应 用 程序 的 main 类 应 该 相同 ， 使 用 @DiscoveryClient 注解 。 以 下 是 市 
路 由 配置 的 application.yml 文件 。 与 前 一 个 示例 相 比 ， 唯 一 的 变化 是 每 个 已 定义 路 由 的 
uri 属性 。 开 发 人 员 可 以 使 用 从 具有 了 lb 前 缀 的 发 现 服务 器 (如 lb://order-service) 获取 的 名 
称 ， 而 不 是 提供 网 络 地 址 。 


SpIring: 
application: 
name: gateway—Service 
cloud: 
gateway: 
dliscovery: 
locator: 
enabled: 七 TUe 
routes: 
-1d: account—-service 
uri: lb://account—-service 
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predicates: 

一 Path=/account/** 

Filterss 

—- RewritePath=/account/ (?<path>.*), /s$\{path)} 
— 1d: customer—service 

uri: lb://customer-service 

predicates: 

- Path=/customer/** 

11iters: 

- RewritePath=/customer/ (?<path>.*), /ss\{path]} 
- 1d: order—service 

uri: lb://order-service 

predicates: 

- Path=/order/** 

下 于 直下 已 于 号 

- RewritePath=/order/ (?<path>.*), /$\{pathl} 
1d: product— service 

uri: J]b://product—service 

predicates: 

- Path=/product/** 

下 于 下 上 已 下 有 

- RewritePath=/product/ (?<path>.*), /ss$\{path)} 


B83 小 结 


在 介绍 完 API 网 关 之 后 ， 本 书 就 已 经 完成 了 关于 Spring Cloud 中 基于 微服 务 的 架构 
的 核心 元 象 实现 的 讨论 。 阅 读 完 本 书 的 这 一 部 分 之 后 ， 开 上 及 人员 应 该 能 够 目 定 义 和 使 用 
Eureka、Spring Cloud Config、Ribbon 、Feign 和 Hystrix 等 工具 , 最 后 还 可 以 使 用 基于 Zuul 
和 Spring Cloud Gateway 的 网 关 。 

本 章 可 以 被 视 为 两 种 可 用 解决 方案 的 比较 一 一 较 旧 的 Netflix Zuul 和 最 新 的 解决 方案 
Spring Cloud Gateway。 其 中 ， 第 二 种 解决 方案 仍 在 不 断 变化 。 它 的 当前 版 本 2.0 只 能 在 
Spring 5 中 使 用 ， 并且 在 发 行 版 中 仍然 不 可 用 。 第 一 种 解决 方案 Netflix Zuul 则 是 稳定 的 ， 
但 它 不 文 持 异 步 和 非 阻 蹇 连接 等 特性 。 它 仍然 基于 Netflix Zuul 1.0， 当然 也 有 一 个 新 版 本 
的 Zuul 文 持 异步 通信 。 不 管 它们 之 间 的 区 别 如 何 ， 本 章 已 经 描述 了 如 何 使 用 这 两 种 解决 
方案 提供 简单 和 更 高 级 的 配置 。 基 于 前 面 章 节 中 的 示例 ， 本 章 还 介绍 了 与 服务 发 现 、 客 
户 端 负载 均 衔 器 和 断路 妖 的 集成 。 
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在 将 一 体 化 应 用 程序 分 解 为 微服 务 时 ， 开 发 人 员 通 常会 花费 大 量 的 时 间 考 虑 业务 边 
界 或 应 用 程序 逻辑 的 分 区 ， 却 扎 记 了 日 志 。 根 据 笔者 上 自己 作为 开发 人 员 和 软件 架构 师 的 
经 验 ， 一 方面 ， 可 以 说 很 多 开发 人 员 通 常 都 不 太 关 注 日 志 记 录 ; 而 男 一 方面 ， 人 负责 应 用 
程序 维护 的 操作 团队 却 主 要 依赖 于 日 志 。 无 论 开 发 人 员 所 关注 的 领域 如 何 ， 也 无 论 他 们 
eee 所 有 应 用 程序 都 必须 执行 日 志 记 录 ， 这 是 无 
可 争辩 的 。 但 是 ， 微 服务 强制 为 应 用 程序 日 志 的 设计 和 排列 添加 了 一 个 全 新 的 维度 ， 因 
oe own 全 
有 大 量 的 请 求 由 多 个 服务 处 理 。 开 发 人 员 必 须 将 这 些 请 求 关联 在 一 起 ， 并 将 所 有 日 志 存 
储 在 一 个 中 心 位 置 ， 以 便 更 容易 查看 它们 。Spring Cloud 引入 了 一 个 专用 库 ， 实 现 了 分 布 
式 跟 中 解决 方案 Spring Cloud Sleuth 。 

这 里 还 有 一 件 事 需要 讨论 。 日 志 记 录 (Logging) 与 跟踪 (Tracing) 不 一 样 ， 开 发 人 
员 有 必要 了 解 一 下 它们 之 间 的 差异 。 跟 踩 是 指 跟 踩 程序 的 数据 流 。 技 术 文 持 团 队 通 第 使 
用 它 来 诊断 间 题 发 生 的 位 置 。 对 于 开发 人 员 来 说 ， 只 有 在 出 现 错误 时 才 必 须 跟踪 系统 流 
以 发 现 性 能 “ 瓶 贷 ” 或 时 间 。 日 志 记 录用 于 错误 报告 和 检测 。 与 跟踪 相 反 ， 它 应 该 始终 
局 用 。 当 设计 一 个 大 型 系统 并 和 希望 跨 机 器 进行 恨 好 而 灵活 的 错误 报告 时 ， 一 定 要 考虑 以 
集中 方式 收集 日 志 数 据 。 推 荐 和 最 流行 的 解决 方案 是 ELK (Elasticsearch + Logstash + 
Kibana) 堆栈 。Spring Cloud 中 没有 用 于 此 堆栈 的 专用 库 , 但 可 以 使 用 Java 日 志 框 架 (如 
Logback 或 Log4j) 实现 集成 。Zipkin 将 在 本 章 中 讨论 另 一 种 工具 。 它 是 一 种 典型 的 跟 踩 
工具 ， 可 帮助 收集 可 用 于 解决 微服 务 架构 中 的 延迟 问题 的 时 序数 据 。 

本 章 将 要 讨论 的 主题 包括 : 
基于 微服 务 的 系统 中 日 志 记 录 的 最 佳 实践 。 
使 用 Spring Cloud Sleuth 将 跟踪 信息 附加 到 消息 并 关联 到 事件 。 
集成 Spring Boot 应 用 程序 和 Logstash 。 
使 用 Kibana 显示 和 过 滤 日 志 条 目 。 
使 用 Zipkin 作为 分 布 式 跟 踊 工具， 并 通过 Spring Cloud Sleuth 将 其 与 应 用 程序 集成 。 


DLL DO L 


9.1 微服 务 的 最 住 日 志 记 录 实 践 


处 理 日 志 记 录 最 重要 的 最 佳 实 践 之 一 是 跟踪 所 有 传 入 请 求 和 传 出 啊 应 。 也 许 这 对 于 
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部 分 开发 人 员 来 说 是 显而易见 的 ， 但 我 们 也 曾经 看 到 过 一 些 不 符合 该 要 求 的 应 用 程序 。 
如 末 满 足 此 需求 ， 则 基于 微服 务 的 架构 将 会 产生 一 个 后 果 ， 即 与 没有 消 轧 传递 的 单一 应 
用 程序 相 比 ， 该 系统 中 的 日 志 总 数 会 有 所 增加 。 这 反 过 来 也 会 要 求 开 发 人 员 比 以 前 更 加 
关注 日 志 。 我 们 应 该 尽 可 能 地 生成 尽 可 能 少 的 信息 ， 即 使 这 些 信息 可 以 告诉 我 们 很 多 情 
况 。 如 何 实现 这 一 目标 ? 首先 ， 在 所 有 微服 务 中 使 用 相同 的 日 志 消 息 格 式 就 不 失 为 一 个 
展 策 。 例 如 ， 可 以 考虑 如 何在 应 用 程序 日 志 中 打印 变量 。 鉴 于 通常 在 微服 务 之 则 交换 的 
消 轧 会 使 用 JSON 进行 格式 化 ,所 以 建议 开发 人 员 使 用 JSON 表示 法 。 此 格式 具有 非常 简 
单 的 标准 ， 使 日 志 易 于 阅读 和 解析 。 以 下 束 是 一 个 日 志 的 片段 。 

E33 712 INFO Order received: 

iI“3d":1], customerid 9, product Ld” :10] 

上 面 的 格式 显然 比 以 下 格式 更 容易 分 析 。 


下 INFO Order received with id 1, customerId 5 and productId 
有 


但 是 一 般 来 说 ， 最 重要 的 是 标准 化 。 无 论 选 择 哪 一 种 格式 ， 在 什么 地 方 使 用 它 才 至 
关 重 要 。 开 发 人 员 还 应 该 小 心 确保 日 志 有 意义 ， 尽 量 避 免 不 包 合 任 何 信息 的 句子 。 例 如 ， 
从 以 下 格式 中 完全 看 不 出 来 正在 处 理 哪 个 订单 。 


dd INFO Processing order 


但 是 ， 如 果 确 实 需要 这 种 日 志 条 目 格 式 ， 则 可 以 党 试 将 其 分 配给 不 同 的 日 志 级 别 。 
使 用 相同 级 别 的 INFO 记录 所 有 内 容 确 实 是 一 种 不 好 的 做 法 。 某 些 类 型 的 信息 比 其 他 信息 
更 重要 ， 因 而 这 里 的 一 个 难点 是 确定 应 记录 日 志 条 目的 级 别 。 以 下 是 一 些 建议 。 

口 跟踪 (TRACE) : 这 是 非常 详细 的 信息 ， 仅 用 于 开发 模式 。 可 以 在 部 署 到 生产 

环境 之 后 将 其 保留 一 小 段 时 间 ， 并 将 其 视 为 临时 文件 。 
口 调试 (DEBUG) : 在 此 级 别 将 记录 程序 中 发 生 的 任何 事情 。 这 主要 用 于 开发 人 
员 的 调试 或 故障 排除 。DEBUG 和 TRACE 之 间 的 区 别 可 能 是 最 困难 的 。 

口 信息 (INFO) : 在 此 级 别 应 记录 操作 期 间 最 重要 的 信息 。 这 些 消 息 必 须 易 于 理 
解 ， 不 仅 适 用 于 开发 人 员 ， 也 适用 于 管理 员 或 高 级 用 户 ， 以 便 让 他 们 快速 了 解 
应 用 程序 正在 执行 的 操作 。 

口 “警告 (WARN) : 在 此 级 别 将 记录 可 能 会 出 错 的 所 有 事件 。 这 样 的 过 程 可 能 会 

继续 ， 但 开发 人 员 应 该 格外 小 心 。 

口 错误 (ERROR) : 通常 会 在 此 级 别 打 印 异常 。 这 里 重要 的 是 不 要 在 所 有 地 方 抛 

出 异常 ， 例 如 ， 如 果 只 有 一 个 业务 逻辑 执行 没有 成 功 ， 则 不 应 该 影响 整个 程序 。 

口 ”致命 (FATAL) : 此 Java 日 志 记 录 级 别 指定 可 能 导致 应 用 程序 终止 的 非常 严重 
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的 错误 事件 。 

虽然 可 能 还 有 其 他 一 些 很 好 的 日 志 记 录 实 践 ， 但 我 们 已 经 提 到 的 都 是 在 基于 微服 务 
的 系统 中 使 用 的 最 重要 的 日 志 实 践 。 关 于 日 志 记 录 ， 还 有 一 个 方面 值得 一 提 ， 那 就 是 规 
范 化 。 如 果 开 发 人 员 和 希望 轻松 理解 和 解释 目 己 的 日 志 ， 则 应 该 清楚 地 了 解 它 们 的 收集 方 
式 和 时 间 、 它 们 包含 的 内 容 以 及 它们 释 出 的 原因 。 应 该 在 所 有 微服 务 中 规范 化 一 些 特 
别 重要 的 特征 ， 如 Time (发 生 的 时 间 ) 、Hostname (发 生 的 主机 名 〉 和 AppName (发 生 
的 程序 名 ) 。 正 如 9.2 节 所 示 ， 当 在 系统 中 实现 集中 收集 日 志 的 方法 时 ， 这 种 规范 化 非常 
有 用 。 


9.2 使 用 Spring Boot 记录 日 志 


Spring Boot 将 使 用 Apache Commons Logging 进行 内 部 日 志 记 录 , 但 是 ， 如 果 要 包含 
启动 器 的 依赖 项 ， 则 默认 情况 下 将 在 应 用 程序 中 使 用 Logback。 它 不 会 抑制 以 任何 方式 使 
用 其 他 日 志 框 架 的 可 能 性 。 还 为 Java Util Logging、Log4J2 和 SLF4J 提供 了 默认 配置 。 可 
以 在 application.yml 文件 中 使 用 logging.* 属 性 配置 日 志 记 录 设 置 。 默 认 日 志和 输出 包含 以 量 
秒 为 单位 的 日 期 和 时 间 、 日 志 级 别 、 进 程 ID 、 线 程 名 称 、 已 发 出 条 目的 类 的 全 名 以 及 消 
昌 。 可 以 通过 分 别 对 控制 台 和 文件 追加 程序 使 用 logging.pattern.console 和 logging. 
pattern file 属性 来 履 盖 它 。 
默认 情况 下 ，Spring Boot 仅 记 录 到 控制 侣 。 除 了 控制 全 输出 之 外 ， 要 允许 写 入 日 志 
文件 ， 则 应 该 设置 logging .file 或 logging.path 属性 。 如 果 指 定 logging.file 属性 ， 则 日 志 将 
在 相对 于 当前 目录 的 确切 位 置 写 入 文件 。 如 果 设 置 logging.path， 则 会 在 指定 目录 中 创建 
spring.log 文件 。 达 到 10MB 后 ， 日 志文 件 将 被 轮换 (Rotate)。 
application.yml 设置 文件 中 可 以 自 定 义 的 最 后 一 件 事 是 日 志 级 别 。 默 认 情 况 下 , Spring 
Boot 会 使 用 ERROR、WARN 和 INFO 级 别 写 入 消息 。 我 们 可 以 使 用 logging.level.* 属 性 
为 每 个 包 或 类 窗 新 此 设置 。 
也 可 以 使 用 logging.levelroot 配置 根 日 志 记 录 器 (Root Logger) 。 以 下 是 application.yml 
文件 中 的 示例 配置 ， 它 更 改 了 默认 模式 格式 以 及 一 些 日 志 级 别 ， 并 设置 了 日 志文 件 的 位 置 。 
logging: 
file: logs/order.1o0og 
level: 
com.netflix: DEBUG 
org.springframework.web.filter.commonsRegquestLoggingFilter: DEBUG 
pattern: 
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console: "$d{HH:mm:ss.SSS} $$-Slevel $msg$n" 
file: "$d{HH:mm:33.8383} -v1level Smsg$n" 


正如 上 例 所 示 ， 这 样 的 配置 非常 简单 ， 但 在 某 些 情况 下 ， 这 还 不 够 。 如 果 要 定义 其 
他 退 加 器 (Appender) 或 过 滤器 ， 则 应 明确 包括 其 中 一 个 可 用 日 志 记 录 系 统 的 配置 。 这 
样 的 日 志 系 统 如 Logback (logback-spring.xml) 、Log4j2 (log4j2-spring.xml) 或 Java Util 
Logging (loggingproperties) 。 如 前 文 所 述 ， 默 认 情 况 下 ，Spring Boot 将 使 用 Logback 
作为 应 用 程序 日 志 。 如 果 在 类 路 径 的 根 目 录 中 提供 logback-spring.xml 文件 ， 它 将 窗 亲 
application.yml 中 定义 的 所 有 设置 .例如 , 开发 人 员 可 以 创建 每 天 轮换 日 志 的 文件 退 加 器 ， 
并 保留 最 多 10 天 的 历史 记录 。 

此 功能 在 应 用 程序 中 非常 实用 。9.3 节 将 会 介绍 到 ， 在 将 微服 务 与 Logstash 集成 时 ， 
便 需 要 一 个 自 定义 的 追加 器 。 以 下 是 Logback 配置 文件 的 示例 片段 ， 该 片段 为 logs/ 
order.log 文件 设置 了 每 日 深 动 案 上 略 。 


<confjguration> 
<appender name="FILE" 
class="ch.qos.1logback.core.rolling.RollingFileAppender"> 
<file>logs/order.log</file> 
<rollingPolicy 
class="ch.9qos.1logback.core.rolling.TimeBasedRollingPolicy"> 
<fileNamePattern>order.%d{yyyy-MM-—dd}.log</fileNamePattern> 
<maxHistory>10</maxHistory> 
<totalsizeCap>1lGB</totalSizeCap> 
</rollingPolicy> 
<encoder> 
<pattern>%$d{HH:mm:ss.SSS} $-5level $%msgsn</pattern> 
</encoder> 
</appender> 
<root level="DEBUG"> 
<appender-ref ref="FILE™ /> 
</root> 
</configuration> 


值得 一 提 的 是 ，Spring 建议 为 Logback 使 用 logback-spring.xml 而 不 是 默认 的 
logback.xml。Spring Boot 包含 一 些 Logback 扩展 ， 可 能 对 高 级 配置 有 所 帮助 。 它 们 不 能 
在 标准 logback.xml 中 使 用 ， 而 只 能 在 logback-spring.xml 中 使 用 。 我 们 列 出 了 一 些 扩展 ， 
允许 开 有 友人 员 从 Spring 环境 定义 特定 于 配置 文件 的 配置 或 接口 属性 。 

<springProperty scope="context"” name="springAppName™" 


source="spring.application.name™" /> 
<property name="LOG FILE" value="${BUILD FOLDER:-build}/${springAppName}"/> 
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<springProfile name="development"> 
</springprofile> 


<SpringProfile name="production"> 
<appender name="flatfile™ 
class="ch.qos.logback.core.rolling.RollingFileAppender"> 
<file>s$s{LOG FILE}</file> 
<rollingPolicy 
class="ch.9gqos.1logback.core.rolling.TimeRasedRollingPolicy"> 
<fileNamePattern>${LOG FILE} .Sd{yyyy-MM-dd} .gz</fileNamePattern> 
<maxHistory>1</maxHistory> 
</rollingPolicy> 
<encoder> 
<pattern>5 {CONSOLE LOG PATTERN}</pattern> 
<Charset>utf8</charset> 
</encoder> 
</appender> 


</springProfile> 


9.3 使 用 ELK Stack 集中 日 志 


ELK 是 3 个 开源 工具 一 一 Flasticsearch、Logstash 和 Kibana 的 首 字 母 缩写 ， 它 也 被 称 
为 弹性 堆栈 (Elastic Stack) 。 该 系统 的 核心 是 Elasticsearch， 这 是 一 个 基于 另 一 个 用 Java 
编写 的 开源 项 目 Apache Lucene 的 搜索 引擎 。 该 库 特别 适用 于 需要 跨 平 台 环 境 中 的 全 文 搜 
索 的 应 用 程序 。Elasticsearch 流行 的 主要 原因 是 它 的 性 能 。 当 然 , 它 还 具有 其 他 一 些 优 点 ， 
如 可 伸缩 性 、 灵 活性 和 易于 集成 , 因为 它 可 以 提供 基于 JSON 的 RESTful API 来 搜索 已 存 
储 的 数据 。 它 有 一 个 庞大 的 网 络 讨 论 社区 和 许多 用 例 ， 但 对 我 们 来 说 最 有 趣 的 是 它 能 够 
存储 和 搜索 应 用 程序 生成 的 日 志 。 记录 日 志 是 在 ELK Stack 中 包含 Logstash 的 主要 原因 。 
这 个 开源 数据 处 理 管 道 允 许 [发 人 员 收集 、 处 理 和 输入 数据 到 Elasticsearch 。 

Logstash 文 持 许多 从 外 部 源 提取 事件 的 输入 。 有 趣 的 是 它 有 很 多 输出 ， 而 Elasticsearch 
只 是 其 中 之 一 。 例 如 ， 它 可 以 将 事件 写 入 Apache Kafka、RabbitMQ 或 MongoDB， 它 可 
以 将 指标 数据 写 入 InfluxDB 或 Graphite。 它 不 仅 可 以 接收 数据 并 将 数据 转发 到 目的 地 ， 
还 可 以 动态 解析 和 转换 数据 。 
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Kibana 是 ELK Stack 的 最 后 一 个 元 素 。 它 是 Elasticsearch 的 开源 数据 可 视 化 插件 。 它 
允许 开发 人 员 可 视 化 、 探索 和 发 现 Elasticsearch 中 的 数据 。 开 发 人 员 可 以 通过 创建 搜索 查 
询 轻松 显示 和 过 滤 从 应 用 程序 收集 到 的 所 有 上 日志。 在 此 基础 上 ， 开 发 人 员 还 可 以 将 数据 
导出 为 PDF 或 CSV 格式 以 提供 报告 。 


9.3.1 在 机 器 上 设置 ELK 堆 材 


和 尝试 将 任何 日 志 从 应 用 程序 发 送 到 Logstash 之 前 ， 开 发 人 员 必 须 在 本 地 计算 机 上 
配置 ELK Stack。 最 合适 的 运行 方式 是 通过 Docker 容器 。 堆 栈 中 的 所 有 产品 都 可 用 作 
Docker 镜像 。 有 一 个 专门 的 Docker 注册 表 由 Elastic Stack 的 供应 商 托 管 。 有 关 已 发 布 镜 
像 和 标签 的 完整 列表 ， 请 访问 www.docker.elastic.co 查找 。 所 有 这 些 都 将 使 用 centos:7 作 
为 基本 镜像 。 

我 们 将 从 Elasticsearch 实例 开始 。 可 以 使 用 以 下 命令 启动 它 的 开发 。 

docker run -d --name es -p 9200:9200 -p 9300:9300 -e 

"discovery .type=single-node" 

docker .elastic.co/elasticsearch/elasticsearch:6.1.1 

在 开发 模式 下 运行 Elasticsearch 是 最 方便 的 运行 方式 , 因为 我 们 不 必 提 供 任何 其 他 配 
置 。 如 果 要 在 生产 模式 下 局 动 它 ， 则 需要 将 vm.max map count Linux 内 核 设 置 为 至 少 
262144。 修 改 它 的 过 程 因 操作 系统 平台 而 异 。 对 于 带 有 Docker Toolbox 的 Windows 系统 
来 说 ， 必 须 通过 docker-machine 设置 。 

docker-machine ssh 

sudo sysctl -w vm.max map count=262144 


下 一 步 是 使 用 Logstash 运行 容器 。 除 了 使 用 Logstash 启动 容器 之 外 ， 开 发 人 员 还 应 
该 定义 输入 和 输出 。 输 出 很 明显 ， 就 是 Elasticsearch， 现 在 可 以 在 默认 的 Docker 机 器 地 
址 192.168.99.100 下 使 用 它 。 作 为 输入 ， 我 们 定义 了 简单 的 TCP 插件 logstash-input-tcp， 
它 与 我 们 的 示例 应 用 程序 中 用 作 日 志 记 录 追 加 器 的 LogstashTcpSocketAppender 兼容 。 我 
们 的 微服 务 中 的 所 有 日 志 都 将 以 JSON 格式 发 送 。 所 以 ， 现 在 为 该 插件 设置 json 编 解码 
器 非常 重要 。 每 个 微服 务 都 将 使 用 其 名 称 和 micro 前 级 (显然 这 是 为 了 表示 它 是 微服 务 ) 
在 Elasticsearch 中 编制 索引 。 以 下 是 Logstash 配置 文件 logstash.conf。 
input 1{ 
tcCP 1 
port => 5000 
codec => JSson 
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} 
} 


output 1{ 
elasticsearch 1 
hosts => |["http://192.168.99.100:9200™] 
index => "micro--${appNamel}" 
} 
} 
以 下 是 运行 Logstash 并 在 靖 口 5000 上 公开 它 的 命令 。 它 还 会 将 具有 上 述 设置 的 文件 
复制 到 容器 并 有 覆盖 Logstash 配置 文件 的 默认 位 置 。 
docker run -d --name logstash -p 5000:5000 -Vv ~/logstash.conf:/config- 
dir/logstash.conf docker.elastic.co/logstash/logstash-oss:6.1.1 -f 
/config- dir/logstash.conf 


最 后 , 开发 人 员 可 以 运行 堆栈 的 最 后 一 个 元 素 Kibana。 默认 情况 下 , 它 将 在 端口 5601 
上 公开 ， 并 连接 到 端口 9200 上 可 用 的 Elasticsearch API， 以 便 能 够 从 那里 加 载 数 据 。 
docker run -dd --name kibana -e 


"ELASTICSEARCH URL=http://192.168.99.100:9200" -Pp 5601:5601 
docker.elastic.co/kibana/kibana:6.1.1 


如 果 开 发 人 员 想 在 Windows 系统 的 Docker 机 器 上 运行 所 有 Elastic Stack 产品 ， 则 可 
能 需要 将 Linux 虚拟 映像 的 默认 RAM 内 存 增加 到 最 小 2GB。 启动 所 有 容 右 之 后 , 开发 人 
员 最 终 可 以 访问 http://192.168.99.100:5601 下 的 Kibana 仪表 板 ， 然 后 继续 将 应 用 程序 与 
Logstash 集成 。 


9.3.2 ”将 应 用 程序 与 ELK Stack 集成 


通过 Logstash 将 Java 应 用 程序 与 ELK Stack 集成 的 方法 有 很 多 种 。 其 中 一 种 方法 涉 
及 使 用 Filebeat， 它 是 本 地 文件 的 日 志 数 据 发 送 器 。 此 方法 需要 为 Logstash 实例 配置 的 
beats (logstash-input-beats) 输入， 这 实际 上 是 默认 选项 。 开 发 人 员 还 应 该 在 服务 器 计算 
机 上 安装 并 局 动 Filebeat 守护 程序 。 它 负责 将 日 志 传 递 给 Logstash。 

束 个 人 而 言 ， 笔 者 更 喜欢 基于 Logback 和 专用 奶 加 器 的 配置 。 它 似乎 比 使 用 Filebeat 
代理 更 简单 。 除 了 必须 部 署 其 他 服务 外 ，Filebeat 还 要 求 我 们 使 用 解析 表达 式 ， 如 Grok 
过 滤器 。 使 用 Logback 退 加 器 时 ， 不 需要 任何 日 志 发 送 程序 。 这 个 退 加 器 在 项 目 Logstash 
JSON 编码 器 中 可 用 。 开 发 人 员 可 以 通过 在 logback-spring.xml 文件 中 声明 net.logstash. 
logback.appender.LogstashSocketAppender appender 来 为 自己 的 应 用 程序 启用 它 。 
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我 们 还 将 讨论 使 用 消息 代理 将 数据 发 送 到 Logstash 的 蔡 代 方法 。 在 我 们 即将 讨论 的 
示例 中 , 将 演示 如 何 使 用 Spring AMQPAppender 将 日 志 事 件 发 布 到 RabbitMQ 交换 消息 。 
在 这 种 情况 下 ，Logstash 将 订阅 该 消息 并 使 用 已 发 布 的 消息 。 

1. 使 用 LogstashTCPAppender 


库 logstash-logback-encoder 可 以 提供 3 种 类 型 的 人 退 加 右 一 一 UDP、TCP 和 异步 
(Async) 。TCP 追加 占 是 最 第 用 的 。 值 得 一 提 的 是 ，TCP 妃 加 器 是 异步 的 ， 所 有 的 编码 
和 通信 都 被 委托 给 一 个 线程 。 除 了 妃 加 器 之 外 ， 该 库 还 提供 了 一 些 编码 器 和 布局 ， 使 开 
发 人 员 能 够 以 JSON 格式 记录 日 志 。 因 为 Spring Boot 默认 包含 一 个 Logback 库 ， 以 及 
spring-boot-starter-web， 所 以 我 们 只 需要 为 Maven 的 pom.xml 添加 一 个 依赖 项 即 可 。 
<dependency> 
<groupId>net.logstash.logback</groupId> 
<artifactId>logstash-logback-encoder</artifactId> 
<version>4.11l</version> 
</dependency> 


下 一 步 是 在 Logback 配置 文件 中 使 用 LogstashTCPAppender 类 定义 追加 器 。 每 个 TCP 追加 
圳 都 要 求 开 发 人 员 配 置 编码 器 。 可 以 在 LogstashEncoder 和 LoggingFEventCompositeJsonEncoder 
之 加 做 出 选择 。 

LoggingEventCompositeJsonEncoder 可 以 为 开发 人 员 提 供 更 大 的 灵活 性 。 它 由 一 个 或 
多 个 映射 到 JSON 输出 的 JSON 提供 程序 组 成 。 默认 情况 下 ， 如 果 没 有 配置 JSON 提供 程 
序 ， 那 么 它 不 会 按 LogstashTCPAppender 的 方式 工作 。 它 默认 包含 大 干 个 标准 字段 ， 如 
时 间 惟 、 版 本 、 日 志 程 序 名 称 和 堆栈 跟踪 等 。 此 外 ， 它 还 会 添加 来 目 映 射 诊断 上 下 文 

(Mapped Diagnostic Context，MDC) 的 所 有 条 目 和 上 上 下文， 当然 ， 开 发 人 员 也 可 以 通过 
将 includeMdec 或 includeContext 属性 中 的 一 个 设置 为 false 来 禁用 它 。 


<appender name="STASH" 
class="net.1logstash.1logback.appender.LogstashTcpSocketAppender"> 
<destination>192.168.99.100:5000</destination> 
<encoder 
class="net.1logstash.logback.encoder.LoggingEventCompositeJsonEncoder"> 

<providers> 

<mdc /> 

<cContext /> 

<logLevel /> 

<loggerName /> 

<pattern> 

<pattern> 
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{ 


"appName: "Order service” 
} 
</pattern> 
</pattern> 
<threadName /> 
<message /> 
<logstashMarkers /> 
<stackTrace /> 
</providers> 
</encoder> 
</appender> 


现在 再 回来 看 一 看 我 们 的 示例 系统 。 开 发 人 员 仍 然 可 以 在 同一 个 Git 存储 库 
(https://github.com/piomin/sample-spring-cloud-comm.git ) 和 feign with discovery 分 文 
(https://github.com/piomin/sample-spring-cloud-comm/tree/feign with discovery) 找到 访 示 

例 。 笔 者 已 根据 第 9.1 节 “ 微 服务 的 最 佳 日 志 记 录 实 践 ” 中 提出 的 建议 在 源 代码 中 添加 了 
一 些 日 志 记 录 条 目 。 以 下 是 order-service 服务 中 POST 方法 的 当前 版 本 。 笔者 已 经 通过 从 
org.slf4j.LoggerFactory 调用 getLogger 方法 将 SLF4J 上 的 Logback 用 作 日 志 记 录 程 序 。 


QPostMapping 
public Order prepare (RequestBody Order order) throws 
JsonProcessingException | 
int price = 0; 
List<Product> products = 
productClient.findBylIds (order.getProductlIds (} ); 
LOGGER .Into ( Products found: {}", mapper.writeValueAsSstring (products)}) ); 
Customer customer = 
customerClient.findByIdWithAccounts (order.getcCcustomerIld (})}); 
LOGGER.infol("Customer found: {}", mapper.writeValueAsstring (customer) ) ， 
for (Product product : products) 
price += product.getPrice(}; 
final int priceDiscounted = priceDiscount (price, customer}); 
LOGGER.1info("Discounted price: 1{}", 
mapper .writeValueAsString(Collections.singletonMap ("price"™, 
priceDiscounted})}}); 
Optional<Account> account = customer.getAccounts () .stream() .filter (a 一 > 
(a.getBalance(})} > priceDiscounted)}))}) .findFirst(); 
if (account.isPresent()) i 
order.setAccountld(account .get (}) -GetId() ) ; 
order.setSstatus (Orderstatus.ACCEPTED); 
order.setPrice (priceDiscounted}; 
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LOGGER .Into( "Account found: {+1}"™, 
mapper.writeValueAsSstring(account .get () ) ) 7 
1} else 1 
order.setsSstatus (Orderstatus .REJECTED),; 
LOGGER. info("Account not found: {}", 
mapper.writeValueAsstring (customer.getAccounts () )); 


} 


return repository.add (order),; 


} 


现在 来 看 一 看 如 图 9.1 所 示 的 Kibana 仪表 板 。 它 可 以 在 http://192.168.99.100:5601 处 
获得 。 在 该 仪表 板 中 可 以 轻松 发 现 和 分 析 应 用 程序 日 志 。 在 页 面 左 侧 的 菜单 中 可 以 选择 
所 需 的 索引 名 称 〈 在 图 9.1 的 屏幕 截图 中 标记 为 1) 。 日 志 统 计 信 息 显 示 在 时 间 线 图 ( 标 
记 为 2) 上 。 可 以 通过 单 击 具体 条 或 选择 一 组 条 来 缩小 搜索 参数 所 采用 的 时 间 。 给 定时 间 
段 内 的 所 有 日 志 都 显示 在 图 表 下 方 的 面板 上 (标记 为 3) 。 


图 9.1 Kibana 仪表 板 
可 以 扩展 每 个 条 目 以 查看 其 详细 信息 。 在 详细 的 Table( 表 ) 视图 中 ， 我 们 可 以 看 到 
诸如 Elasticsearch 索引 〈_ index) 的 名 称 以 及 微服 务 的 级 别 或 名 称 (appName) 。 大 多 数 
这 些 字段 都 已 经 通过 LoggineEventCompositeJsonEncoder 设置 。 我们 只 定义 了 一 个 特定 于 
应 用 程序 的 字段 appName， 如 图 9.2 所 示 。 
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四 December 29th 2017, 10:27:348.41i0 Products found: [{"1d™:3,"name" :本 下 于 十 了 "price™ :2000},{" "1d :8 " name :" Testt" ,price” :1250}] 


Table J50N 


netdata. ip_address 加 全 加 党 192.168.9393.,1 
Bt1imestamp 克 全 品尝 December 2h 207, 10:27:48.410 
vers1on 入 刀口 诗 1 


_ 1 由 各 总 口 kGEoWABFCH ooGSYUSXP 
_index 全 总 口 Micro-order -ser Yice 
_5COFme 

_type daoc 

避让 可 er 一 SP vice 


appMame 


192.168.993.,1 


涩 
host 财 
索 
10gger_name 案 Bl.pPiomin. services.order. controller.0rderController 
六 
崇 
过 


level 
Ts Products found: [4"1d" :3 "name":"Test3", "price s20001,{"1d" :8B,"name":" Test , "price" :1250}] 
portt 


52 ,803 


thr ead_nanme http-niogo-80930—exXec—2 


图 9.2 查看 Table ( 表 ) 视图 


Kibana 提供 了 搜索 特定 条 目的 强大 功能 。 开 发 人 员 可 以 仅 通 过 单 击 所 选 条 目 来 定义 
过 滤器 ， 以 便 定 义 一 组 搜索 条 件 。 在 图 9.2 中 ， 可 以 看 到 如 何 使 用 传 入 的 HTTP 请 求 过 滤 
掉 所 有 和 条目。 如 前 文 所 述 ，org.springframework.web filter.CommonsRequestLoggingFilter 类 
负责 记录 这 些 日 志 。 我 们 刚刚 定义 了 一 个 过 滤器 ， 其 名 称 等 于 完全 限定 的 日 志 记 录 器 类 名 
称 。 如 图 9.3 所 示 是 笔者 的 Kibana 仪表 板 屏幕 ， 它 显示 了 仅 由 CommonsRequestLoggingFilter 
生成 的 日 志 。 
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Mae 
Fear 


Before reyuest [uri=/rheaders=tyccent=[acr licetion sen, application ASOm] content-tppre=[applicstion json; Char set=UTF-s)]: content-—length=[37]. host=[ 
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9.3 ”使 用 过 滤器 生成 的 日 忘 
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2. 使 用 AMQP 追加 器 和 消息 代理 

使 用 Spring AMQP 追加 器 和 消息 代理 的 配置 比 使 用 简单 TCP 追加 器 的 方法 要 稍微 复 
杂 一 些 。 首 先 ， 开 发 人 员 需 要 在 本 地 计算 机 上 启动 消息 代理 。 本 书 已 经 在 第 5 章 “ 使 用 
Spring Cloud Config 进行 分 布 式 配置 ”中 详细 介绍 了 此 过 程 ， 其 中 还 专门 介绍 了 RabbitMQ， 
以 便 使 用 Spring Cloud Bus 重新 加 载 动态 配置 。 如 果 开 发 人 员 已 在 本 地 或 作为 Docker 容 
器 启动 了 RabbitMQ 实例 ， 则 可 以 继续 进行 配置 。 必 须 创 建 一 个 队列 来 发 布 传 入 事件 ， 然 
后 将 其 绑 定 到 交换 消息 〈Exchange) 。 

要 实现 此 目的 ， 应 该 先 登 录 Rabbit 管理 控制 台 ， 然 后 转 到 Queues 〈 队 列 ) 部 分 。 我 
们 已 经 创建 了 一 个 名 为 q logstash 的 队列 , 并且 使 用 名 称 eg_ logstash 定义 了 新 的 Exchange 
消息 ， 如 图 9.4 所 示 。 对 于 所 有 示例 微服 务 ， 队 列 都 已 经 使 用 路 由 键 值 绑 定 到 该 Exchange 
消息 。 


R a bbit 3.6.14 Erlang 19.2.1 


Overview Connections Channels Exchanges Dueues Admin 


Exchange: ex_logstash 
*™ Overview 

Message rates last minute ? 

Currently idle 


Detalls 


Type | direct 


Features durable: true 
Policy 
”“ Bindings 
This exchange 


U 


Routing key Arguments 


30cOUMN t-service 
9_logstash 


To 
customer-seryice i 
9_logstash 


ordear-service : 
9_logstash 


图 9.4 新 定义 的 Exchange 消 忆 
在 局 动 并 配置 了 RabbitMQ 的 实例 之 后 ， 即 可 开始 在 应 用 程序 端 集成 。 首 先 ， 开发 人 
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员 必 须 在 项 目 依赖 项 中 包含 spring-boot-starter-amqp， 以 提供 AMQP 客户 端 和 AMQP 追 
加 圳 的 实现 。 


<dependency> 
<OroupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-amqp</artifactId> 
</dependency> 


然后 ， 唯 一 要 做 的 就 是 使 用 Logback 配置 文件 中 的 org.springframework.amqp.rabbit. 
logback.AmqpAppender 类 来 定义 妃 加 上 器。 需要 设置 的 最 重要 的 属性 是 RabbitMQ 网 络 地 
址 (host 和 port)、 己 声明 的 交换 消 和 县 名 称 (exchangeName) 和 路 由 键 值 CroutingKeyPattern )， 
该 键 值 必 须 和 已 声明 交换 消 恕 绑 定 的 键 值 之 一 匹配 。 与 TCP 人 退 加 器 相 比 ， 这 种 方法 的 缺 
点 是 需要 上 自己 准备 发 送 给 Logstash 的 JSON 消息 。 以 下 是 order-service 服务 的 Logback 
配置 的 一 个 片段 。 


<appender name="AMOP" 
class="org.springframework.amgqp.rabbit.logback.AmqpAppender"> 
<layout> 

<pattern> 

Ll 

"time": "$%Sdate{ISO8601}", 

"thread": "$$thread™, 

de re 

“lass = agerl dl) 

“mesSSsage”: “Tmessage” 

} 

</pattern> 
</lavyout> 
<host>192.168.99.100</host> 
<port>56712</port> 
<uUuSername>guest</username> 
<password>guest</password> 
<applicationId>order-service</applicationId> 
<routingKeyPattern>order-service</routingKeyPattern> 
<declareExchange>true</declareExchange> 
<exchangeType>direct</exchangeType> 
<exchangeName>ex logstash</exchangeName> 
<gqenerateld>true</generatelId> 
<charset>UTF-8</charset> 
<durable>true</durable> 
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<deliveryMode>PERSISTENT</deliveryMode> 
</appender> 
Logstash 可 以 通过 声明 rabbitmq (logstash-input-rabbitmq) 输 入 轻松 地 与 RabbitMQ 
集成 。 
input 1 
rabbitmg 1 
host => "192.168.99.100" 
port => D672 
durable => true 
exchange => “ex logstash” 
} 
} 


output 1{ 
elasticsearch 1 
hosts => ["http://192.168.99.100:9200™] 
} 
} 


9.4 Spring Cloud Sleuth 


Spring Cloud Sleuth 是 一 个 相当 小 的 简单 项 目 ， 它 为 日 志 记 录 和 跟踪 提供 了 一 些 有 用 
的 功能 。 如 果 和 仔细 研究 “使 用 LogstashTCPAppender” 小 节 中 讨论 的 示例 ， 就 可 以 很 容易 
地 看 出 它 不 可 能 过 滤 与 单个 请 求 相 关 的 所 有 日 志 。 在 基于 微服 务 的 环境 中 ， 在 处 理 进 入 
系统 的 请 求 时 ， 关 联 应 用 程序 交换 的 消 轧 也 非 弟 重要 。 这 是 创建 Spring Cloud Sleuth 项 目 
的 主要 动机 。 

如 果 为 应 用 程序 启用 了 Spring Cloud Sleuth， 它 会 向 请 求 添加 一 些 HTTP 标 头 ， 这 人 
许 开 发 人 员 将 请 求 与 啊 应 和 已 交换 的 消息 链接 起 来 ， 这 个 交换 是 由 独立 应 用 程序 完成 的 ， 
而 链接 则 可 以 通过 RESTful API 之 类 的 接口 完成 。 它 定义 了 两 个 基本 的 工作 单位 : 跨度 

(Span) 和 跟踪 〈Trace) 。 每 一 个 单位 都 由 唯一 的 64 位 了 D 标识 。 跟 踩 ID 的 值 等 于 路 
度 ID 的 初始 值 。 跨度 是 指 单个 交换 其 中 的 啊 应 将 作为 对 请 求 的 反应 而 发 送 。 跟 中 通常 
称 为 关联 IT (Correlation IT) ， 它 将 帮助 开发 人 员 链 接 来 自 不 同 应 用 程序 的 所 有 日 志 ， 
而 这 些 日 志 是 在 处 理 进 入 系统 的 请 求 期 间 生成 的 。 

每 个 跟踪 和 跨度 ID 都 会 添加 到 Slf4J 映射 诊断 上 下 文 (MDC) 中 ， 因 此 ， 可 以 在 日 
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志 聚 合 器 (Log Aggresgator) 中 提取 具有 给 定 跟 中 或 跨度 的 所 有 日 志 。MDC 只 是 一 个 存 
储 当前 线程 上 下 文 数 据 的 映射 。 进 入 服务 器 的 每 个 客户 端 请 求 都 由 不 同 的 线程 处 理 。 由 
于 这 个 原因 , 每 个 线程 都 可 以 在 线程 生命 周期 内 访问 其 MDC 的 值 。 除了 spanId 和 traceld 
之 外 ，Spring Cloud Sleuth 还 同 MDC 添加 了 以 下 两 个 跨度 。 

口 appName: 生成 日 志 条 目的 应 用 程序 的 名 称 。 

口 exportable: 指定 是 否 应 将 日 志 导 出 到 Zipkin 。 

除了 上 述 功 能 之 外 ，Spring Cloud Sleuth 还 可 以 提供 以 下 功能 。 

口 ” 对 常见 分 布 式 跟踪 数据 模型 的 抽象 ， 这 允许 与 Zipkin 的 集成 。 

口 ” 记 录 计 时 信息 ， 以 帮助 进行 延迟 分 析 。 它 还 包括 不 同 的 采样 策略 以 管理 导出 到 
Zipkin 的 数据 量 。 

口 与 参与 通信 的 和 常见 Spring 组 件 集成 , 如 servlet 过 滤器 、 异步 端点 、RestTemplate、 
消息 通道 、Zuul 过 滤器 和 Feign 客户 端 等 。 


9.4.1 将 Sleuth 与 应 用 程序 集成 


要 为 应 用 程序 启用 Spring Cloud Sleuth 功能 , 只 需 将 spring-cloud-starter-sleuth 启动 右 
添加 到 依赖 项 即 可 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-sleuth</artifactId> 
</dependency> 


包含 此 依赖 项 之 后 ， 应 用 程序 生成 的 日 志 条 目的 格式 已 更 改 。 上 有 具体 如 下 所 示 。 


9 

INEO [order-service,9a3fef0169864e80 ,9a3fef0169864e80,falsel 
49212 一 = 一 [nlio—8090— exec—6| 
Pp.p.sS.order.controller.OrderCcontroller : 

Products found:[{"id":2, "name":"Test2", "price"”:1500}, 
{"id":9, name : "Test9", "price" :24501]}|] 

2017 1]2=30 G021:31 .6083 

INEFO [order-service, 9a3ftef0le69864e80,9a3fef0l69864e80,falsel 
49212 -——— [nio-8090- exec—6| 
DpP:3S0Pder.controller.Ordercontrol lier : 

Customer found:{"id":2, "name"”:" "Adam Smith™, 
"type":"REGULAR", "accounts™: 

[{"id™":4, "number":"1234567893", "balance™":50001}, 
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{"id™:5, "number":"1234567894” "balance™:01}, 

{"id":6, "number™:"12345671895", "balance™”:5000}]} 

20Ul1 /一 12-30 00:21:31.684 

INFO [order-service, 9a3fef0l1l694864e80,9a3fef0l]69864e80,falsel 
49212 -——— [nio-8090— exec—6| 
PpP-.PpP.s.order.controller.OrderController 

Discounted price:{ price :31521 

20171—12-30 00:21:31 .684 

INFO [order-service, 9a3ftef0l1l69864e80,9a3fef0l]69864e80,falsel 
4090212 一 -一 [nlio—8090— exec—6| 
PpP.p.S.order.controller.OrderController 

Account found:{"id" :4, "number :"]234561893","balance” :5000} 
a 

INFO [order-service,o58b0ec4c4l2ci6cc,58b0ec4dc4l2ciecc,falsel 
49212 -——— [nio-8090— exec—1| 
pp-PpP.S3.0rder.controller.OrderControl ler 

Order found:{"id" :4,."status”™ : ACCEPTED"”. 

“PEILICe :3192," Customerld":2, "accountld"”:4, "prod uctIids"”: [9,2]} 
A ed es Db it Wet: Rae 

INFO [order-service,8b0e6c4c41l2ci6cc,58b0e6c4dc4l2ciecc,falsel 
49212 -——— [nlo-8090- exec—1| 
pp-pP-.S-.o0rder.controller.OrderControl ier 

ACCGOUNt moOdiEfied: {accountTId :4, price” :3152] 

a 2 3 

INEFO [order-service,o8b0e6c4c4l2ci6cc,58b0ecdc4l2ci6e6cc,falsel 
49212 —-—— [nlio-8090- exec—1| 
ppP-.S.o0rder.controller.OrderControl ler 

Order status changed:1" "status”  : DONE |} 


9.4.2 ”使 用 Kibana 搜索 事件 


Spring Cloud Sleuth 会 目 动 将 HTTP 标 头 X-B3-SpanId 和 X-B3-TraceId 添加 到 所 有 请 
求 和 啊 应 中 。 这 些 字 段 也 将 作为 spanId 和 traceId 包含 在 MDC 中 .但 在 转移 到 查看 Kibana 
仪表 板 之 前 ， 不 妨 来 看 一 看 图 9.5， 这 是 一 个 顺序 示意 图 ， 它 说 明了 示例 微服 务 之 间 的 通 
信 流 程 。 

order-service 服务 公开 了 两 个 可 用 的 方法 。 第 一 个 方法 是 创建 新 订单 ， 第 二 个 方法 是 
确认 订单 .事实 上 ,第 一 个 POST /方法 将 通过 customer-service 服务 直接 从 customer-service 
服务 、product-service 服务 和 account-service 服务 调用 所 有 其 他 服务 的 端点 。 第 二 个 PUT 
/fid} 方 法 仅 与 account-service 服务 中 的 一 个 端点 集成 。 
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CUstomer Service ACCOUNt Service Product Service 


图 9.5 示例 微服 务 之 间 的 通信 流程 


现在 可 以 通过 存储 在 ELK 堆栈 中 的 日 志 条 目 来 映射 先前 描述 的 流程 。 在 使 用 Kibana 
作为 日 志 聚 合 器 的 情况 下 ， 再 加 上 由 Spring Cloud Sleuth 生成 的 字段 ， 开 发 人 员 即 可 通 
过 使 用 跟踪 或 跨度 ID 过 滤 它 们 来 轻松 查找 条 目 。 在 图 9.6 所 示 的 示例 中 ， 可 以 发 现 与 
POST /方法 调用 的 order-service 服务 端点 相关 的 所 有 事件 ， 其 X-B3-TraceId 字段 等 于 
103ec9498 /771519c2 。 


Timme 
BE Tarnuiary 1ith 2018, 
mnuary 11th 2 


到 January iith a0 :2 somer Found: "id :name ”了 本 CD 用 Ryam" "type™ :VIP™"s" ts" "dd" :7 nunber":"i23d567E06" "balance” :OT 有" id" :number” ;1234457 order-ser Victe 


"i number™: "1 


h a TCounts'" :时 
34567899" ,bal ance" :5000m}]} 


anuary 11th 2018， :号 :S 丘 - ccounts Found: [ff"id":7,"nunmnber":"1234567E96", "balence":0},{"id" :8 nunber":™ 1z3456799r" "balance™ :33E0} ,1"1id":9,"number™:"1234567898", "ba customner -ser'wi 


anuary 11th 2018, Er roducts founds: [id" :SE,"name":"Testa” ,price" zs0}.,{" id" :10,"name™ "Test10" Price” rg00] 


EF Tariuary 11th 2018, 


图 9.6 与 POST /方法 调用 问 点 相关 的 所 有 事件 


图 9.7 也 是 一 个 示例 , 它 类 似 于 上 一 个 示例 , 但 处 理 请 求 期 间 存 储 的 所 有 事件 都 将 发 
送 到 PUT /{id} 端 点 。 这 些 条 目 也 已 经 被 X-B3-TraceId 字段 过 滤 掉 ，X-B3-TraceId 字段 的 
值 等 于 7070b90bfb36c961。 


messmge 


1 2017, ss3943.029 Order status changed: "statius": CONE 
th O77 L5343.029 
th 2017, 5:3$9:43029 Curren 画 | 吾 Nic 二 六 


th 2017: s:$ 0 Bccount modified 


sth 2047,. 15:39:43.014 Order found: [id":z 


9.7 与 POST /{id} 方 法 调用 端点 相关 的 所 有 事件 


在 图 9.8 中 可 以 看 到 完整 的 字段 列表 ,这 些 字 段 已 由 微服 务 应 用 程序 发 送 到 Logstash。 
Spring Cloud Sleuth 库 已 将 包含 义 - 前 级 的 字段 包含 在 消 明 中 。 
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- December 29th 2017, 15:39:43.029 Account found: {£"1d" :93,"number”:"1234567898", "balance" :5000,"customerId" :3} 
Table JSDN 


Bmetdata., ip_address 全 总 [0 党 192.]168.99.1 
D1 timestamp 全 总 山 灾 December 29th 20J]7, 15:39:43.029 
Eversion 各 和 从 [党 1 
NX-B3-ParentspanId 四 灾 由 7079b30bfb35c961 
XX-B3-SpanId 口 党 和 站 2db3a2arccal89gc51 
X-B3-TraceTId 口 染 7079b30bfb36ca61 
XA-span-Export 口 党 由 false 
态 侣 口 CK20mABTOW_oGSYV42b6 
全 入 加 MTero-account—sery ee 
口 
人 得 四 半 doc 
太太 品尝 account-servyice 
各 各 品尝 192.168.99.1 
& 扎 口 站 B33 
避 各 加 沼 Pl.piomin.services. account. controller.AccountControl ler 
仁和 四 党 Account found: {"1d" :9 "number™:"l1234567898" "balance" :SO0D,"customerId" :3} 


公 旨 四 闪 57,684 


七 
2 
Es 
可 
2 
+ 
十 
部 
下 
士 
士 
二 
士 
入 
考 
士 


侣 且 品尝 http-nio-8091-exec-2 


图 9.8 完整 的 字段 列表 
9.4.3 ”集成 Sleuth 和 Zipkin 


Zipkin 是 一 种 流行 的 开源 分 布 式 跟踪 系统 ， 它 有 助 于 收集 分 析 基 于 微服 务 的 架构 中 
的 延迟 问题 所 需 的 计时 数据 。 它 能 够 使 用 用 户 界 面 Web 控制 台 收 集 、 查找 和 和 可视化 数据 。 
Zipkin 用 户 界 面 提供 了 一 个 依赖 关系 图 ， 显 示 系 统 中 所 有 应 用 程序 处 理 了 多 少 个 跟踪 请 
求 .Zipkin 由 4 个 元 素 组 成 , 前 面 已 经 提 到 过 其 中 一 个 , 即 Web 用 户 界 面 。 第 二 个 是 Zipkin 
收集 占 ， 它 钠 贡 验证 、 和 存储 和 索引 所 有 传 入 的 跟 踊 数 据 。Zipkin 使 用 Cassandra 作为 默认 
的 后 端 存储 。 它 本 对 也 支持 Elasticsearch 和 MySQL。 最 后 一 个 元 素 是 查询 服务 ， 它 提供 
了 一 个 简单 的 JSON API， 用 于 查找 和 检索 跟踪 。 它 主要 由 Web 用 户 界 面 使 用 。 

1. 运行 Zipkin 服务 器 

开发 人 员 可 以 通过 多 种 方式 在 本 地 运行 Zipkin 服务 器 。 其 中 一 种 方法 涉及 使 用 
Docker 容 右 。 以 下 命令 将 启动 内 存 服 务 器 实例 。 


docker run -d --name zipkin -p 9411: 9411 openzipkin / zipkin 


在 运行 Docker 容器 之 后 ，Zipkin API 在 http://192.168.99.100:9411 可 用 。 或 者 ， 也 可 
以 使 用 Java 库 和 Spring Boot 应 用 程序 启动 它 。 要 为 应 用 程序 启用 Zipkin， 应 该 将 以 下 依 
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赖 项 包含 在 Maven 的 pom.xml 文件 中 ， 如 以 下 代码 片段 所 示 。 默 认 版 本 由 spring-cloud- 
dependencies 管理 。 有 具体 到 本 示例 应 用 程序 ， 则 使 用 了 Edgware.RELEASE Spring Cloud 
版 本 列车 。 
<dependency> 
<qroupId>io.zipkin.java</groupld> 
<artifactId>zipkin—server</artifactId> 
</dependency> 
<dependency> 
<grouplId>io.zipkin.Jjava</groupId> 
<artifactId>zipkin-autoconfigure—ui</artifactId> 
</dependency> 


在 本 示例 系统 中 添加 了 一 个 新 的 zipkin-service 模块 。 这 很 简单 ， 唯 一 需要 实现 的 是 
应 用 程序 main 类 ， 它 使 用 @EnableZipkinServer 进行 注解 。 由 于 这 个 原因 ，Zipkin 实例 将 
赔 入 Spring Boot 应 用 程序 中 。 

QSpringBootApplication 


QEnablezZipkinSserver 
public class zipkinApplication { 


public static void main(string[] args) 1{ 
new 
SpringApplicationBuilder (2ipkinApplication.class} .web (true) .run(args); 


} 


} 
为 了 在 其 默认 端口 上 启动 Zipkin 实例 ， 必 须 覆 盖 application.yml 文件 中 的 默认 服务 
器 端口 。 局 动 该 应 用 程序 之 后 ， 可 在 http://localhost:9411 处 使 用 Zipkin API。 


SpI1ing: 
application: 
name: zipkin—service 


SELVEeEL.: 
port: S${PORT:941]1} 
2. 构建 客户 端 应 用 程序 
如 果 要 在 项 目 中 同时 使 用 Spring Cloud Sleuth 和 Zipkn， 则 只 需 在 依赖 项 中 添加 
spring-cloud-starter-zipkin 启动 器 即 可 ， 它 将 局 用 通过 HTTP API 与 Zipkin 的 集成 。 如 果 
己 将 Zipkin 服务 器 作为 Spring Boot 应 用 程序 内 的 租 入 式 实例 启动 ， 则 不 必 提 供 包 含 连 接 
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地 址 的 任何 其 他 配置 。 如 果 使 用 Docker 容 右 ， 则 应 窗 新 application.yml 中 的 默认 URL。 

Spring: 

交工 得 长 于 站 - 
baseUrl: http://192.168.99.100:9411/ 

开发 人 员 始 终 可 以 利用 与 服务 发 现 的 集成 。 如 果 通 过 @EnableDiscoveryClient 为 使 用 
谱 入 式 Zipkin 服务 器 的 应 用 程序 启用 了 发 现 客户 问 ， 则 可 以 将 属性 spring.zipkin.locator. 
discovery.enabled 设置 为 tue。 在 这 种 情况 下 ， 即 使 它 在 默认 端口 下 不 可 用 ， 所 有 应 用 程 
序 也 可 以 通过 已 注册 名 称 对 其 进行 本 地 化 。 开 发 人 员 还 应 该 使 用 spring.zipkin.baseUrl 属 
性 覆盖 默认 的 Zipkin 应 用 程序 名 称 。 

Spring: 

zpkin: 
baseUrl: http://zipkin-service/ 

默认 情况 下 ，Spring Cloud Sleuth 仅 发 送 一些 选 定 的 传 入 请 求 。 它 由 属性 spring. 
sleuth.sampler.percentage 确定 ， 其 值 必须 是 0.0 和 1.0 之 间 的 两 倍 。 这 个 采样 的 解决 方案 
己 经 实现 ， 因 为 分 布 式 系统 之 间 交 换 的 数据 量 有 时 非常 高 。Spring Cloud Sleuth 提供 了 可 
以 实现 的 采样 器 接口 ， 以 控制 采样 算法 。PercentageBasedSampler 类 中 提供 了 默认 实现 。 
如 果 想 要 跟踪 应 用 程序 交换 的 所 有 请 求 ， 只 需 声 明 AlwaysSampler bean。 它 可 能 对 测试 目 
的 有 用 。 

QBean 

Public Sampler defaultSampler() 1 


return new AlwaysSampler ();} 
] 
(1) 使 用 Zipkin 用 户 界 面 分 析 数 据 
现在 回 到 了 刚才 的 示例 系统 。 如 前 所 述 ， 新 的 zipkin-service 模块 己 被 添加 。 我 们 还 为 
所 有 微服 务 ( 包 括 gateway-service 服务 ) 启用 了 Zipkin 跟踪 。 默 认 情 况 下 ，Sleuth 将 采 
用 值 spring.application.name 作为 span 的 服务 名 称 。 开 发 人 员 可 以 使 用 spring.zipkin. 
service.name 属性 覆 新 该 名 称 。 
要 使 用 Zipkin 成 功 测试 我 们 的 系统 ， 必 须 启 动 微服 务 、 网 关 、 发 现 和 Zipkin 服务 占 。 
要 生成 并 发 送 一 些 测试 数据 ， 可 以 运行 由 pl.piomin.services.gateway.GatewayControllerTest 
类 实现 的 JUnit 测试 。 它 将 通过 gateway-service 服务 加 order-service 服务 发 送 100 条 消息 ， 
这 可 从 http://localhost:8080/apyorder/** 人 处 著 得 。 
现在 来 分 析 Zipkin 从 所 有 服务 中 收集 到 的 数据 。 可 以 使 用 其 用 户 界 面 Web 控制 台 轻 
松 检查 它 。 所 有 跟踪 都 标记 有 服务 的 名 称 跨度 。 如 果 条 目 有 5 个 跨度 ， 则 表示 进入 系统 
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的 请 求 已 由 5 个 不 同 的 服务 处 理 ， 如 图 9.9 所 示 。 


“|| al start me C01032018 5 End time 01-10-2018 


Find Traces 


Showing: 10 of 10 sort Longest First 


Sarvic Es: all | 


E60.258ms 3 5pans 
all Om 


ceount-senace W147nms | gatewary-senvice sz GOms | rder-senice 2 59m 


33.476m5 5 spans 
all 0% 


ccount-senaice XT 4ms (| customer-service sz Ams | gueway-sernvice Kk 33ms | crder-senace x3 42ms5 | Eroduci-service 1 ms 


28. 17r6ms 5 spans 
all Oa 


CCNt-sernedce wl 2ms § customar-samvice zz TOms | garevway-Sorvice RD 28ms | Order-senvice ns 2bms | product-sorvice x1 ms 


26.149ms 3 pans 
all 0 


图 9.9 在 Zipkin 用 户 界 面 查看 从 所 有 服务 中 收集 到 的 数据 


开发 人 员 可 以 使 用 不 同 的 条 件 科 选 条 目 ， 如 服务 名 称 、 哮 度 名 称 、 跟 踪 ID 、 请 求 时 
司 或 持续 时 间 等 。Zipkin 还 可 以 显示 失败 的 请 求 ， 并 按 持续 时 间 、 降 序 或 升序 对 它们 进 
行 排序 ， 如 图 9.10 所 示 。 


all -||al ™ gtarttime 0o103 2018 15-2 01-10-2016 532 Duration (ys) :| 70000 
Limit’ "a Firnd Traces 如 
ES 


Showinag- 10 of 10 Sor: Longest First 


Sarvices 团 


.B37 9 pis 
all O's 


ECOUNI-SETVice Ed 21ms § cuamer Service NB 4473ms | Gemar-sanice Kz 1O1ams order-semnice md 147 3 | Prmdect-service Wl 24ms 


是 下 BBs 各 spains 
all 0% 


ccoun-service x3 1107ms | Customer-service X35 107m | ateway -Sere Wa 1145ms MN onder-Senie wed 1125ms | product-servics 其 | 3168ms 


1.3895 7 spams 
all 0% 


TEL RP arm CUSISMmer- service wa O00ms | aeway.Serrce Ee NSms | Grder-senice Ed 105Ms | Predici-service wi 1a42ms 


00.6572ms 6 spans 


all O's 


ToGoUnl-service Ki FTO Cosiemer- sevices x2 Fads | uateway-oervices Ez Sums | der-oervice 3 sdms | Product-aervice sl 1ms 


图 9.10 ”使 用 不 同 的 条 件 贤 选 条 目 
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开发 人 员 还 可 以 查看 每 个 条 目的 详细 信息 。Zipkin 将 以 可 视 化 方式 显示 参与 通信 的 
所 有 微服 务 之 间 的 流程 。 如 图 9.11 所 示 ， 它 显示 的 是 对 每 个 传 入 请 求 的 数据 的 计时 。 开 
发 人 员 可 以 通过 它 了 解 系统 中 延迟 的 原因 。 


Duration: Services- 已 Depth: © Total Spans: (3 


Expand Bl | Collapse &ll Filter Service Se 


account-senmee x1 N customer-service ne | gateway-sennce na | order-seryce x product-seryice mi 


Searuices 199 4114ms 396 .229ms 594 343ms 792 458ms 990 572ms 
gateway-sernvice D90 572s - hitpapiiorder 


988.000ms : http-/aplorder 
- 1000ms :http.ds 


ol CUStomer-senvlce 94.000ms - http-/withatcountsiez 


: 578.000ms : http:/customer/2 
图 9.11 查看 条 目的 详细 信息 


Zipkin 还 提供 了 一 些 额外 的 有 趣 功能 。 其 中 之 一 是 可 视 化 应 用 程序 之 间 的 依赖 关系 。 
如 图 9.12 所 示 ， 它 显示 了 本 示例 系统 的 通信 流程 。 


Start time 01-09-2019 15:35 End time 01-10-2018 15:30 Analyze Depender les 


ee Ca) 
图 9.12 Zipkin 还 可 以 将 应 用 程序 之 间 的 依赖 关系 可 视 化 
开 皮 人员 可 以 通过 单 击 相关 元 系 来 查看 服务 之 间 已 交换 的 请 和 轧 数 量 , 如 图 9.13 所 示 。 


order-service 


account-service 


Key 


Number of calls 


Number of errors 


图 9.13 碍 看 服务 之 间 已 交换 的 消息 数量 
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(2) 通过 消息 代理 集成 
通过 HTTP 与 Zipkin 集成 不 是 唯一 的 选择 。 与 Spring Cloud 一 样 ， 开 发 人 员 也 可 以 
使 用 消息 代理 作为 代理 。 人 
用 spring-rabbit 依赖 项 包含 在 项 目 中 ， 而 第 二 个 则 可 以 使 用 spring-kafka 包含 在 项 目 串 
这 两 个 代理 的 默认 目标 名 称 都 是 zipkin。 


<dependency> 
<gqroupId>org.springframework.cloud</grouplId> 
<artifactId>spring—cloud-starter—zipkin</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.amqp</grouplId> 
<artifactIid>spring-—rabbit</artifactId> 

</dependency> 


此 功能 还 需要 在 Zipkin 服务 器 端 进 行 更 改 。 我 们 已 经 配置 了 一 个 用 户 来 侦 re 
RabbitMQ 或 Kafka 队列 的 数据 ， 所 以 ， 要 实现 此 目的 ， 只 需 在 项 目 中 包含 以 下 依赖 项 
可 。 开 发 人 员 仍 然 需 要 在 类 路 征 中 使 用 zipkin-server 和 zipkin-autoconfigure-ui 工件 。 


<dependency> 

<aqroupId>org.springframework.cloud</groupId> 
<artifactIid>spring-cloud-sleuth-zipkin-stream</artifactId> 
</dependency> 

<dependency> 

<gqroupId>org .springframework.cloud</grouplId> 
<artifactId>spring-cloud-starter-stream-rabbit</artifactId> 
</dependency> 


开发 人 员 应 该 使 用 @EnableZipkinStreamServer 而 不 是 @EnableZipkinServer 来 注解 应 
用 程序 main 类 。 幸 运 的 是 ，@EnableZipkinStreamServer 也 是 使 用 @EnableZipkinServer 
注解 的 , 这 意味 着 开发 人 员 还 可 以 使 用 标准 的 Zipkin 服务 器 端点 来 收集 HITP 上 的 路 度 ， 
并 使 用 UI Web 控制 台 进 行 搜索 。 

@springBootApplication 


QEnablezipkinstreamServer 
public class ipkinApplication { 


public static void main(String[] args) 1 


TW 


。198 。 精通 Spring Cloud 微服 务 架 构 


SpringApplicationBuilder (2ipkinApplication.class)}) .web (true) .run(args); 
} 


93 小 结 


在 开发 过 程 中 ， 记 录 日 志和 跟踪 通常 都 不 是 很 重要 ,但 这 些 是 维护 系统 时 使 用 的 关 
键 功 能 。 本 章 将 重点 放 在 开发 和 运营 领域 ， 展 示 了 如 何以 多 种 方式 将 Spring Boot 微服 务 
应 用 程序 与 Logstash 和 Zipkin 集成 。 本 章 还 提供 了 一 些 示 例 ， 以 说 明 如 何 为 应 用 程序 局 
用 Spring Cloud Sleuth 功能 ， 从 而 更 轻松 地 监视 许多 微服 务 之 间 的 调用 。 阅 读 完 本 章 之 后 ， 
开发 人 员 还 应 该 能 够 有 效 地 使 用 Kibana 作为 日 志 聚 合 工具 , 并 使 用 Zipkin 作为 跟踪 工具 
来 发 现 系统 内 部 通信 的 “ 瓶 须 ”。 

Spring Cloud Sleuth 与 Elastic Stack 和 Zipkin 一 起 , 似乎 是 一 个 非常 强大 的 生态 系统 ， 
它 提供 了 由 许多 独立 微服 务 组 成 的 系统 监控 问题 的 解决 方案 ， 消 除了 对 于 该 问题 的 任何 
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本 书 第 4 章 “ 服 务 发 现 ” 和 第 5 章 “ 使 用 Spring Cloud Config 进行 分 布 式 配 置 ” 中 
讨论 了 大 量 有 关 服 务 发 现 和 分 布 式 配置 的 内 容 。 我 们 详细 讨论 了 两 种 解决 方案 ， 其 中 的 
第 一 个 解决 方案 是 Eureka， 由 Netflix OSS 提供 ， 并 已 被 Spring Cloud 用 于 服务 发 现 ， 第 
二 个 解决 方案 是 Spring Cloud Config 项 目 ， 仅 专用 于 分 布 式 配置 。 但 是 ， 市 场 上 有 一 些 
有 趣 的 解决 方案 有 效 地 结合 了 这 两 个 功能 。 目 前 ，Spring Cloud 文 持 其 中 两 个 。 

口 “Consul: 该 产品 由 HashiCorp 构建 。 它 是 一 种 高 度 可 用 的 分 布 式 解决 方案 ， 则 在 

足 动 态 分 布 式 基础 架构 连接 和 配置 应 用 程序 。Consul 是 一 个 相当 复杂 的 产品 ， 
具有 多 个 组 件 ， 但 其 主要 功能 是 在 任何 基础 架构 中 发 现 和 配置 服务 。 

口 ”Zookeeper: 该 产品 由 Apache Software Foundation 构建 。 它 是 一 个 用 Java 编写 的 

分 布 式 、 分 层 键 / 值 存储 。 它 则 在 维护 配置 信息 、 命 名 和 分 布 式 同步 。 与 Consul 
相 比 , 它 更 像 是 一 种 原始 的 键 / 值 存储 而 不 是 现代 服务 发 现 工 具 。 但 是 , Zookeeper 
仍然 非常 流行 ， 特 别 是 对 基于 Apache Software 堆栈 的 解决 方案 更 是 如 此 。 

对 该 领域 其 他 两 种 受 欢迎 产品 的 支持 仍 处 于 开发 阶段 。 以 下 项 目 尚 未 添加 到 官方 
Spring Cloud 版 本 列车 中 。 

口 Kubemetes: 这 是 一 个 开源 解决 方案 ， 则 在 实现 最 初 由 Google 创建 的 容器 化 应 

用 程序 的 自动 化 部 著 、 扩 展 和 管理 。 这 个 工具 现在 很 受 欢 迎 。 最 近 ，Docker 平 
台 已 经 开始 文 持 Kubemetes。 

口 ”Etcd: 这 是 一 个 分 布 式 可 靠 的 键 / 值 存储 , 用 于 Go 中 编写 的 分 布 式 系统 的 最 关键 

数据 。 它 被 许多 公司 和 其 他 软件 产品 用 于 生产 ， 如 Kubernetes。 

本 章 将 仅 介 绍 官方 支持 的 解决 方案 ， 即 Consul 和 Zookeeper。Kubernetes 不 仅仅 是 一 
个 键 / 值 存储 或 服务 注册 表 ， 本 书 将 在 第 14 章 “Docker 文 持 ”中 详细 讨论 它 。 


10.1 使 用 Spring Cloud Consul 
Spring Cloud Consul 项 目 可 以 通过 自动 配置 为 Consul 和 Spring Boot 应 用 程序 提供 集 


成 。 通 过 使 用 众所周知 的 Spring Framework 注解 样式 ， 开 发 人 员 可 以 在 基于 微服 务 的 环 
境 中 启用 和 配置 常见 模式 。 这 些 模 式 包括 : 使 用 Consul 代理 进行 服务 上 发现、 使 用 Consul 
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键 / 值 存储 进行 分 布 式 配置 、 使 用 Spring Cloud Bus 进行 分 布 式 事件 以 及 使 用 Consul Events 
等 。 该 项 目 还 文 持 基于 Netflix Ribbon 的 客户 端 负 和 载 均 衡 占 和 基于 Netflix Zuul 的 API 网 
关 。 在 开始 讨论 这 些 功 能 之 前 ， 必 须 先 运行 并 配置 Consul 代理 。 


10.1.1 运行 Consul 代理 


我 们 将 从 在 本 地 计算 机 上 启动 Consul 代理 的 最 简单 方法 开始 .可 以 使 用 Docker 容器 
轻松 设置 独立 开发 模式 。 以 下 命令 将 从 Docker Hub 上 可 用 的 官方 Hashicorp 镜像 启动 
Consul 容器 。 


docker run -d --name consul -p 8500:8500 consul 


在 启动 之 后 ，Consul 的 地 址 为 http://192.168.99.100:8500。 它 公开 了 RESTful HTTP 
API， 这 也 是 它 的 主 接口 。 所 有 API 路 由 都 以 /V1/ 为 前 级 。 当 然 ,， 它 不 需要 直接 使 用 API。 
有 一 些 编程 库 可 以 更 方便 地 使 用 API， 其 中 一 个 是 consul-api， 客 户 端 用 Java 编写 ， 内 部 
也 由 Spring Cloud Consul 使 用 。Consul 提供 的 Web 用 户 界 面 仪表 板 在 与 HITP API 相同 
的 地 址 下 可 用 ， 但 在 不 同 的 上 下 文 路 径 m 上。 它 允 许 查看 所 有 已 注册 的 服务 和 节点 ， 查 
看 所 有 运行 状况 检查 及 其 当前 状态 ， 以 及 读 取 和 设置 键 / 值 数 据 。 

如 前 文 所 述 ， 我 们 将 使 用 Consul 的 3 个 不 同 功能 一 一 代理 、 事 件 和 键 值 存 储 。 它 们 
的 对 应 端点 分 别 是 /agent、/event 和 /kv。 最 有 趣 的 代理 端点 是 与 服务 注册 相关 的 端点 。 
表 10.1 是 这 些 代 理 端 点 的 列表 。 


表 10.1 代理 端点 列表 

记 "EE 
它 将 返回 使 用 本 地 代理 注册 的 服务 列表 。 如 果 Consul 
GET /agent/services 以 集群 模式 运行 ， 则 该 列表 可 能 与 /catalog 端点 在 集 
群 成 员 之 间 执 行 同步 之 前 报告 的 列表 不 同 
它 将 同 本 地 代理 添加 新 服务 。 代 理 负 责 管理 本 地 服 
务 , 以 及 将 更 新 发 送 到 服务 器 以 执行 全 局 目录 的 同步 
它 将 从 本 地 代理 中 删除 具有 service id 的 服务 。 该 代 
理 负责 使 用 全 局 目录 取消 已 注册 的 服务 

/kv 羡 点 专用 于 管理 简单 的 键 / 值 存储 ， 这 对 于 存储 服务 配置 或 其 他 元 数据 特别 有 用 。 
值得 注意 的 是 ， 每 个 数据 中 心 都 有 自己 的 KV 存储 ， 因 此 ， 要 在 多 个 节点 之 间 共 享 它 ， 
开发 人 员 应 该 配置 Consul 复制 守护 进程 。 表 10.2 是 管理 键 / 值 存储 的 3 个 端点 的 列表 。 


PUT /apent/service/replster 


PUT /agent/service/dereglster/:service 1d 
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表 10.2 管理 键 / 值 存储 的 3 个 端点 

Ss 说 有明 

它 将 返回 给 定 键 名 的 值 。 如 果 请 求 的 键 值 不 存在 ， 则 返回 HTTP 状态 404 
作为 响应 

PUT 它 用 于 向 存储 中 添加 新 键 值 ， 或 通过 键 名 更 新 现 有 键 什 

这 是 最 后 一 个 CRUD 方法 ， 用 于 删除 单个 键 值 ， 或 者 删除 具有 相同 前 缀 的 
所 有 键 值 


Spring Cloud 使 用 Consul Events 提供 动态 配置 重新 加 载 。 有 两 种 简单 的 API 方法 。 
第 一 种 是 PUT /event/fire/:name， 它 将 触发 一 个 新 事件 。 第 二 种 是 GET /event/list， 它 将 返 
回 一 个 事件 列表 ， 并 且 可 以 按 名 称 、 标 记 、 节 点 或 服务 名 称 进 行 过 滤 。 
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GET /kv/:key 


DELETE /kv/:key 


要 在 项 目 中 激活 Consul 服务 发 现 ， 应 该 在 依赖 项 中 包含 spring-cloud-starter-consul- 
discovery 月 动 右 。 如 果 要 使 用 Consul 局 用 分 布 式 配置 ， 只 需 包 含 spring-cloud-starter- 
consul-config。 在 某 些 情况 下 ， 开 发 人 员 可 能 会 在 客户 疹 应 用 程序 中 使 用 这 两 个 功能 ， 这 
样 的 话 就 应 该 声明 对 spring-cloud-starter-consul-all 工件 的 依赖 。 

<dependency> 

<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-consul-all</artifactId> 
</dependency> 

默认 情况 下 ，Consul 代理 应 在 地 址 localhost:8500 下 可 用 。 如 果 开 发 人 员 的 应 用 程序 
有 所 不 同 ， 则 应 在 application.yml 或 bootstrap.yml 文件 中 提供 相应 的 地 址 。 

SpI1ing: 

cloud: 
Consul: 


host: 192.168.99.100 
port: 182500 


10.1.3 服务 发 现 


通过 使 用 通用 Spring Cloud @EnableDiscoveryClient 注解 main 类 ， 可 以 为 应 用 程序 
启用 使 用 Consul 的 服务 上 发现。 有 关 详 细 设置 ， 可 以 参考 本 书 第 4 章 “ 服 务 发 现 ”， 因 为 
它 与 Eureka 相 比 没有 区 别 ， 其 默认 服务 名 称 也 取 自 ${spring.application.name} 必 性。 
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使 用 Consul 作为 发 现 服务 器 的 示例 微服 务 可 以 在 GitHub 存储 库 的 https://github.conmy 
piomin/sample-spring-cloud-consul.git 上 获得 。 该 系统 的 架构 与 前 面 章节 中 的 示例 相同 。 它 
有 4 个 微服 务 : order-service 服务 、product-service 服务 、customer-service 服务 和 account- 
service 服务 ，API 网 关 在 gateway-service 模块 中 实现 。 对 于 服务 间 通 信 ， 则 将 Feign 客户 
痛 与 Ribbon 负载 均衡 器 一 起 使 用 。 

QSspringBootApplication 

QEnableDiscoveryClient 


QEnableFeignClients 
public class CustomerApplication 1 


public static void main(Sstring[|] args) | 
new 
SpringApplicationBuilder (CustomerApplication.class) .web (true) .run (args)}); 


} 
} 


默认 情况 下 ，Spring Boot 应 用 程序 在 Consul 中 注册 ， 其 实例 ID 是 通过 从 属性 
spring.application.name、spring.profiles.active 和 server.port 获取 的 值 连接 在 一 起 而 生成 的 。 
在 大 多 数 情况 下 ， 确 保 DD 是 唯一 的 就 足够 了 ， 但 如 果 需 要 上 自 定义 模式 ， 则 可 以 使 用 
spring.cloud.consul.discovery.instanceld 属性 轻松 设置 。 


Spring: 
Cloud: 
Consul: 
discovery: 
instanceld: 
$s {spring.application.name} :$5{vcap.application.instance id:s${spring.applicat 
ion.instance id:${random.valuel}}} 


在 启动 所 有 示例 微服 务 之 后 ， 即 可 查看 Consul 用 户 界面 仪表 板 。 此 时 应 该 看 到 注册 
了 4 种 不 同 的 服务 ， 如 下 面 的 屏幕 截图 10.1 所 示 。 
或 者 , 开发 人 员 也 可 以 使 用 RESTful HTTP API 端点 GET /v1/agent/services 查看 已 注 
册 服 务 的 列表 。 以 下 是 JSON 啊 应 的 片段 。 
“USLOMIr SerVice ZO0nel1 BO92” >: 4 
"ID”: "customer—service—zonel]-8092", 
"Service": "customer—service”, 


"Tags rh = [ ] 有 
"address"”: “minkowp-1.p4.0rg", 
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“Port”: 8092, 
"EnableTagOverride”: Talse, 
"CreateIndex": 0, 
"ModifyIndex": 0 

} ， 

"Order-service—zonel-8090™: 1 
"ID": "order-service—zonel-8090", 
"Service": "order-service", 
“Tags : |[], 

"BAddress™: "minkowp—l.p4.0rg", 
“Port”™: B090, 
"EnableTagOverride": false, 
"CreateIndex™: 0, 
"ModifylIndex": 0 


order-service 


全 入 5 
的 口 tags 
NODES 


172bdSfsf91f 127.00 
Sert Health Status serlHealih 


SErvice "Grder-service" theck senmicennierserdce.romei .sn 


图 10.1 查看 Consul 用 户 界 面 仪表 板 


现在 ， 可 以 使 用 pl.piomin.services.order.OrderControllerTest JUnit 测试 类 通过 癌 
order-service 服务 发 送 一 些 测 试 请 求 来 轻松 测试 整个 系统 。 一 切 都 应 该 工作 得 很 好 ， 和 
Eureka 的 发 现 一 样 。 

1. 运行 状况 检查 

Consul 可 以 通过 调用 /health 端点 来 检查 每 个 已 注册 实例 的 运行 状况 。 如 果 不 和 希望 在 
类 路 径 中 提供 Spring Boot Actuator 库 ， 或 者 如 果 开 发 人 员 的 服务 存在 一 些 问题 ， 那 么 它 
将 在 Web 仪表 板 上 显示 ， 如 图 10.2 所 示 。 

如 果 运 行 状况 检查 端点 由 于 任何 原因 在 不 同 的 上 下 文 路 径 下 可 用 ， 则 可 以 使 用 
spring.cloud.consul.discovery.healthCheckPath 属性 履 兰 该 路 径 。 还 可 以 通过 使 用 模式 定义 
healthCheckInterval 来 更 改 状 态 刷 新 间 隅 ， 例 如 ，10s 表示 10 秒 ，2m 表示 2 分 钟 。 
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SPpIring: 
cloud: 
COonNnsul: 
discovery: 
healthCheckPath: admin/health 
healthcCcheckInterval: 20s 


account-service 


TAGS 


EE 
| Nt 


No tags 
comsul NGDES 


必 册 二 ET 和 T= 各 作 站 i 2 passing 172bdsStsto1f 1a7.0.c 


sert Health Statuys serfHeallh 


172bdsf5f1f 127.0.0.1 
se Health status sarHealih 


忆 忆 WT 加 才 在 BUT vice" Check sorviceactoaunl-serrice-rong 人 2 


图 10.2 ”运行 状况 检查 


2. 区 域 
本 书 在 第 4 章 “ 服 务 发 现 ” 中 已 经 详细 介绍 了 可 用 于 Eureka 发 现 的 分 区 机 制 。 当 主 
机 放置 在 不 同 的 位 置 ， 而 开发 人 员 叉 希望 在 同一 区 域 中 注册 的 实例 之 间 进 行 通 信 时 ， 它 
非常 有 用 。 虽 然 Spring Cloud Consul 的 官方 说 明文 档 (http://cloud.spring.io/spring-cloud- 
static/spring-cloud-consul/1.2.3.RELEASE/single/spring-cloud-consulhtml) 对 这 梓 的 解决 方 
案 未 置 一 词 ， 但 羊 运 的 是 这 并 不 意味 着 它 无 法 实现 。Spring Cloud 可 以 提供 基于 Consul 
标记 的 分 区 机 制 。 开 发 人 员 可 以 使 用 spring.cloud.consul.discovery.instanceZone 属性 配置 应 用 
程序 的 默认 区 域 . 它 使 用 传递 的 值 设 置 spring.cloud.consul.discovery.defaultZoneMetadataName 
属性 中 配置 的 标记 。 默 认 元 数据 标签 的 名 称 为 zone。 
现在 继续 讨论 示例 应 用 程序 。 我 们 已 经 使 用 两 个 配置 文件 (zonel 和 zone2) 扩展 了 
所 有 配置 文件 。 以 下 是 order-service 服务 的 bootstrap.yml 文件 。 
SpIring: 
application: 
name: order—service 
Cloud: 
CONSU1: 


host: 192.168.99.100 
port: 8500 
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spring: 
Brofiles: Zonel 
Cloud: 
CoNnsul: 
discovery: 
instanceaone: zonel 
SeTVeT: 
Port : ${PORT:8090} 


SpI1ing: 
profiles: zone2 

cloud: 

Consul: 

diseovery: 
instanceaone: Zone 

SeTVeT : 
port: ${PORT:9090} 


在 两 个 不 同 区 域 中 注册 的 每 个 微服 务 都 有 两 个 运行 实例 。 使 用 mvn clean install 命令 
构建 整个 项 目 后 ， 应 该 启动 具有 活动 配置 文件 zonel 或 zone2 的 Spring Boot 应 用 程序 ， 
如 java -jar --spring.profiles.active=zonel target/order-service-1.0-SNAPSHOT.jar。 开 发 人 员 
可 以 在 NODES (节点 ) 中 看 到 使 用 区 域 标记 的 已 注册 实例 的 完整 列表 。 如 图 10.3 所 示 为 
此 时 的 Consul 仪表 板 视 图 。 

人 SERVICES 


17r2bd5fef91f 1 


国 172bd5f5f91f 


Utervice 
3CEOUNt-Service 
CINRE 有 由 


| 


尼 岂 ttGimieF= 和 Fle 
rome=Z70mel 


志 册 tim 人 f= 生 关 Fi 时 
CONE=27ONeE 

fT 可 |BEF= 号 记 FW | 它 量 
oe=70Ne 
Birguet=SeFYiee 

FP ta | 


product-seryvice 
li oh. 


图 10.3 在 NODES 中 可 以 看 到 使 用 区 域 标记 的 已 注册 实例 的 完整 列表 
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本 架构 中 的 最 后 一 个 元 素 是 基于 Zuul 的 API 网 关 。 我 们 还 将 在 不 同 的 区 域 中 运行 两 
个 gateway-service 服务 实例 .我 们 希望 在 Consul 中 省 略 注册 , 并 且 只 人 允许 获取 配置 , Ribbon 
客户 疹 在 执行 负载 均衡 时 使 用 访 配 置 。 以 下 是 gateway-service 服务 的 bootstrap.yml 文件 
的 片段 , 它 己 经 通过 将 spring.cloud.consul.discovery .register 和 spring.cloud.consul.discovery. 
registerHealthCheck 属性 设置 为 false 禁用 了 注册 。 

SpIring: 

profiles: zonel 

cloud: 

COTSUJ : 

discovery: 

instancesone: zonel 

regqlister: false 

reglsterHealthCheck: alse 

SErVer: 

port: S${PORT:8080} 


Spring: 

Profiljes: ZONe2 

cloud: 

consul: 

discovery: 

instance2one: zonez 
TEqJISEEr: False 
registerHealthCheck: false 
Seve 

port: S${PORT:9080] 


3. 客户 靖 自 定义 设置 

可 以 通过 配置 文件 中 的 属性 自 定义 Spring Cloud Consul 客户 端 。 其 中 一 些 设 置 已 在 
本 章 前 面 的 小 节 中 介绍 过 。 其 他 有 用 的 设置 已 在 表 10.3 中 列 出 。 所 有 这 些 都 以 spring. 
cloud.consul.discovery 为 前 级 。 


表 10.3 ”客户 端 自 定义 设置 
属 性 说 明 
enabled 设置 是 否 为 应 用 程序 月 用 或 禁用 Consul 发 现 
rit 在 服务 注册 期 间 如 果 为 tue 则 抛 出 异常 否则 , 它 会 记录 警告 日 志 
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续 表 
属 性 默 认 值 说 。 明 
hostname | 在 Consul 中 注册 时 设置 实例 的 主机 名 
DreferIpAddress 强制 应 用 程序 在 注册 期 间 发 送 其 他 地 址 而 不 是 主机 名 
scheme 设置 服务 是 否 在 HTTP 或 HTTPS 协议 下 可 用 


serverListQueryTags a 人 允许 通过 单个 标记 过 滤 服 务 
ServiceName oo 履 盖 服务 名 称 ， 默 认 情 况 下 从 属性 spring.application.name 获取 
taps ”” -| 使 用 在 注册 服务 时 使 用 的 值 设置 列表 标记 

4. 以 集群 模式 运行 

到 目前 为 止 ， 我们 通常 会 局 动 一 个 单独 的 Consul 实例 。 但 这 只 是 开发 模式 中 的 合适 
解决 方案 ， 对 于 生产 模式 来 说 是 不 够 的 。 在 生产 模式 中 ， 我 们 会 希望 拥有 一 个 可 扩展 的 
生产 级 服务 发 现 基础 架构 ， 其 中 包含 一 些 在 集群 内 部 协同 工作 的 节点 。Consul 提供 了 对 
集群 的 支持 , 它 将 在 成 员 之 间 通 信 时 使 用 Gossip 协议 , 在 选举 领导 时 使 用 Raft 共识 协议 。 
在 此 我 们 不 想 介绍 该 过 程 的 细节 ， 但 是 应 该 说 明 一 些 关 于 Consul 架构 的 基础 知识 。 

我 们 已 经 讨论 过 Consul 代理 ， 但 它 完 竟 是 什么 ， 以 及 它 的 作用 是 什么 并 没有 得 到 解 
释 。 代 理 是 Consul 集群 的 每 个 成 员 长 期 运行 的 守护 程序 。 它 可 以 在 客户 端 或 服务 器 模式 
下 运行 。 所 有 代理 都 负责 在 全 局 范围 内 运行 检查 并 保持 在 不 同 节 点 和 同步 中 注册 的 服务 。 

本 节 的 主要 目标 是 使 用 Docker 镜像 设置 和 配置 Consul 集群 .首先 ,我 们 将 局 动容 嚣 ， 
它 充当 集群 的 领导 者 。 当 前 使 用 的 Docker 命令 与 独立 的 Consul 服务 器 只 有 一 个 区 别 。 我 
们 设置 了 环境 变量 CONSUL BIND INTERFACE=eth0， 以 便 将 集群 代理 的 网 络 地 址 从 
127.0.0.1 更 改 为 可 用 于 其 他 成 员 容器 的 网 络 地 址 。 笔 者 的 Consul 服务 器 现在 在 内 部 地 址 
172.17.0.2 上 运行 。 要 查看 你 的 地 址 ( 它 应 该 是 相同 的 ), 可 以 运行 命令 docker logs consul。 
容器 局 动 后 将 记录 适当 的 信息 。 

docker run -d --name Consul-1L -p 8500:8500 -e CONSUL BIND INTERFACE=eth0 

Consul 


了 解 该 地 址 非常 重要 ， 因 为 现在 我 们 必须 将 它 作 为 集群 连接 参数 传递 给 每 个 成 员 容 
独 局 动 命令 。 我 们 还 通过 将 0.0.0.0 设置 为 客户 疹 地 址 将 其 绑 定 到 所 有 接口 。 现 在 ， 可 以 
使 用 -p 参数 轻松 地 在 客户 端 代理 API 之 外 公开 客户 端 代理 API。 

docker run -dd --name consul-2 -p 8501:8500 consul agent -server - 

client=0.0.0.0 -Join=172.17.0.2 


docker run -dd --name consul-3 -p 8502:8500 consul agent -server - 
client=0.0.0.0 -JjJoin=172.17.0.2 


在 使 用 Consul 代理 运行 两 个 容器 之 后 ， 可 以 通过 在 领导 者 (Leader) 的 容器 上 执行 


。 708 。 精通 Spring Cloud 微服 务 架 构 


如 图 10.4 所 示 的 命令 来 检查 集群 成 员 的 完整 列表 。 


$$ docker exec -t consyul-1 consuyul members 
Node Address status Type Build Protocol 
Ub3e3cedddge C172.17.0.3:8301 alive FUeF 自 . 乌 .和 了 立 


Tb4e6GB1319ed 172.17.0.2:8301 alive 全 局 FUGF 和 .9.3 2 
4129a8226624 172.17.D.4:8301 alive SGruer 08.9.3 2z 


图 10.4 使 用 命令 检查 集群 成 员 的 完整 列表 


Consul 服务 器 代理 在 8500 端口 上 公开 ， 而 成 员 代 理 在 端口 8501 和 8502 上 公开 。 即 
使 微服 务实 例 将 自身 注册 到 成 员 代 理 ， 集 群 的 所 有 成 员 也 可 以 看 到 它 ， 如 图 10.5 所 示 。 


4b3c3c84dd96 


引 电 EE 可 二 


El 
?ThAché ied4ded 站 四 


轩 生 这 生病 rvice 丰台 用 生 则 | 


[de Fw | 必 章 


看 『 略 站 F< 生 总 二 


10.5 集群 的 所 有 成 员 都 能 看 到 在 成 员 代 理 上 注册 的 微服 务实 例 


开发 人 员 可 以 通过 更 改 配置 属性 轻松 更 改 Spring Boot 应 用 程序 的 默认 Consul 代理 
地 址 。 
SpI1ing: 
application: 
name: customer—service 
Cloud: 
CONnsul: 
host: 192.168.99. 180 
port: £8500] 


10.1.4 分布 式 配 置 


对 于 在 类 路 径 中 使 用 Spring Cloud Consul Config 库 的 应 用 程序 来 说 ， 它 们 将 在 引导 
阶段 从 Consul 键 / 值 存储 中 获取 配置 。 也 就 是 说 , 默认 情况 下 , 会 存储 在 /config 文件 夹 中 。 
当 开 有 上 有 人员 要 创建 一 个 新 键 值 时 ， 必 须 设置 一 个 文件 夹 路 径 。 访 路径 将 用 于 标识 键 值 并 
将 其 分 配给 应 用 程序 。Spring Cloud Config 会 尝试 根据 应 用 程序 名 称 和 活动 配置 文件 解析 存 
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储 在 文件 夹 中 的 属性 。 假设 我 们 已 经 在 bootstrap.yml 文件 中 将 spring.application name 属性 设 
置 为 order-service， 并 将 spring.profiles.active 运行 参数 设置 为 zonel， 那 么 它 会 尝试 按 以 
下 顺序 查找 属性 源 : config/order-service、zonel/、 config/order-service/、 config/ application、 
zonel/、config/application/。 对 于 所 有 没有 与 服务 相关 的 属性 源 的 应 用 程序 来 说 ， 包 含 前 
组 config/application 的 所 有 文件 夹 就 是 它们 的 默认 配置 。 

1. 管理 Consul 中 的 属性 

回 Consul 添加 单个 键 值 的 最 便捷 方式 是 通过 其 Web 仪表 板 。 男 一 种 方法 是 使 用 /kv 
HTTP 端点 ， 这 在 本 章 开 头 已 经 介绍 过 。 在 使 用 Web 控制 台 时 ， 必 须 转 到 KEY/VALUE 

( 键 / 值 ) 视 图， 然后 就 可 以 查看 所 有 当前 存在 的 键 和 值 ， 并 通过 以 任何 格式 提供 其 完整 

路 径 和 值 来 创建 新 的 键 ， 如 图 10.6 所 示 。 


CONFIG/ + 


DUTt=Service,zoneil 


Create Key 


aCC 
GEDUTt=Serv|ce,. one2 


| 直人 je ei cont Oraer-sernice ZoONEAsener. on 
[| o treate a ter, end he Key With 束 


[ae 
| order-service, zonet! 
加 product-service, ronet/ 


加 Eraduct-Service, Tone 


LELETE FLUEK 


图 10.6 ”查看 键 和 值 
每 个 键 值 都 可 以 更 新 或 删除 ， 如 图 10.7 所 示 。 


CONFIGIACCOUNT-SERVIGE,2ZOQONETI + 


SErver.port ] 


spring.cloud.consul.discowvery.instancezone 


config/account-service,zone 1/server.port 


TALIDATE J $0NM | DELETE KEY | 


10.7 键 值 管理 


s 了 
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要 访问 使 用 Consul 中 存储 的 属性 源 的 示例 应 用 程序 ， 应 该 切换 到 与 上 一 个 示例 相同 
的 存储 库 中 的 分 支配 置 。 我 们 已 经 为 每 个 微服 务 创建 了 键 值 server.port 和 spring.cloud. 
consul.discovery.instanceZone， 而 不 是 在 application.yml 或 bootstrap.yml 文件 中 定义 它 。 

2. 客户 端 定制 

可 以 使 用 以 下 属性 目 定 义 Consul Config 客户 端 ， 这 些 属性 以 spring.cloud.consul. 
config 为 前 级 。 


口 enabled: 通过 将 此 属性 设置 为 false， 可 以 禁用 Consul Config。 如 果 已 经 包含 了 
spring-cloud-starter-consul-all， 那 么 这 将 非 芝 有 用 ， 因 为 后 者 会 后 用 发 现 和 分 布 
式 配 站 。 

口 ”fail-fast: 设置 是 否 在 配置 但 找 期 间 抛 出 异常 或 在 连接 失败 时 抛 出 日 志和 敬告。 将 
其 设置 为 true 人 允许 应 用 程序 正常 继续 月 动 。 

口 ”prefix: 这 将 设置 所 有 配置 值 的 基本 文件 光 ， 默 认 情 况 下 为 /config。 

口 defaultContext: 这 将 设置 所 有 没有 特定 配置 的 应 用 程序 使 用 的 文件 夹 名 称 ， 默 
认 情 况 下 为 /application。 例 如 ， 如 果 将 其 覆盖 到 app， 则 应 在 /config/apps 文件 夹 
中 搜索 属性 。 

口 “profileSeparator: 默认 情况 下 ， 使 用 逗号 将 应 用 程序 名 称 分 隔 为 配置 文件 。 该 属 
性 允许 履 盖 该 分 隔 符 的 值 。 例 如 ， 如 果 将 其 设置 为 ::， 则 应 创建 文件 夹 
/config/order-service::zonel/。 以 下 就 是 一 个 示例 。 

spring: 

Cloud: 
CEOsul: 
config: 


enabled: true 
prefix: props 
defaultContext: app 


profijleSseparator: 


有 了 时， 开发 人 员 会 希望 存储 以 YAML 或 Properties 格式 创建 的 一 堆 属 性 ， 而 不 是 单 
个 键 / 值 对 。 在 这 种 情况 下 ， 应 该 将 spring.cloud.consul.config.format 属性 设置 为 YAML 
或 PROPERTIES。 然 后 ， 应 用 程序 将 查找 位 于 具有 数据 键 的 文件 夹 内 的 配置 属性 ， 如 
config/order-service、zonel/data、config/order-service/data、config/application、Zzonel/data 或 
config/application/data。 可 以 使 用 spring.cloud.consul.config.data-key 属性 更 改 默认 数据 键 。 

3. 观察 配置 更 改 

10.1.3 节 中 讨论 的 示例 将 在 应 用 程序 启动 时 加 载 配 置 。 如果 开 发 人 员 和 希望 重新 加 载 该 
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配置 ， 则 应 将 HITP POST 发 送 到 /refresh 端点 。 为 了 检查 这 样 的 刷新 对 示例 应 用 程序 的 
影 啊 方 式 ， 我 们 修改 了 负责 创建 一 些 测试 数据 的 应 用 程序 代码 片段 。 到 目前 为 止 ， 它 已 
作为 存储 库 @Bean 提供 ， 其 中 包含 一 些 人 硬 编码 的 内 存 中 的 对 象 。 来 看 以 下 代码 。 
QBean 
CustomerRepository repository(}) | 
CustomerRepository repository = new CustomerRepository(); 
repository.add (new Customer("John Scott", CustomerType.NEW) ); 
repository.add (new Customer("Adam Smith", CustomerType.REGULAR))}); 
repository.add (new Customer ( Jacob Ryan", CustomerType.VIP)); 


return repository; 


} 


我 们 的 目标 是 使 用 Consul 键 / 值 功能 将 上 述 代码 移动 到 配置 存储 。 要 完成 此 目标 ， 必 
须 为 每 个 对 象 创建 3 个 键 ， 其 名 称 分 别 为 4、name 和 type。 配 置 则 是 从 具有 repository 
前 组 的 属性 加 载 的 。 

RefreshScope 

QRepository 

QConfigurationpProperties (prefix = "repository") 

Public class CustomerRepository 1 


private List<Customer> customers = new ArrayList<>{(); 


public List<Customer> getCustomers () I 
return customers; 


} 


public Vvoid setCustomers (List<Customer> customers) | 
this.customers = customers; 
| 
人 
} 
下 一 步 是 使 用 Consul Web 仪表 板 为 每 个 服务 定义 适当 的 键 值 。 如 图 10.8 所 示 的 是 包 
舍 Customer 对 象 的 列表 的 示例 配置 。 该 列表 将 在 应 用 程序 启动 时 初始 化 。 
开发 人 员 可 以 更 改 每 个 属性 的 值 。 由 于 Consul 能 够 查看 键 值 前 级 ， 更 新 事件 将 自动 
发 送 到 应 用 程序 。 如 果 存 在 新 配置 数据 ， 则 刷新 事件 将 发 布 到 队列 。 所 有 队列 和 交换 消 
息 都 是 在 Spring Cloud Bus 的 应 用 程序 启动 时 创建 的 ， 它 作为 spring-cloud-starter-consul-all 
的 依赖 项 包含 在 项 目 中 。 如 果 应 用 程序 接收 到 此 类 事件 ， 那 么 它 会 在 日 志 中 打印 以 下 
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信息 
[um WT 


Refresh keys changed: [repository.customers[l1] .namel] 


(= DDES KEYMALUE 


CONFIGICUSTOMER-SERVICE,ZONE1I + 


repository.customers[0].d 

config/customer-senvice,zone l/repository.customers[1l.name 
rapository.customers[d.name 
repository.customers[0].type Piotr PAIMBOWS KI 


repository.sustormers(l1].idy 


| rapository.custormers[1].narme 


Tepesiltory.custorners[ ll.ty pe CAMCEI WALIDATE JSo DELETE KEY 


repository.custormers2l.id 


repository. customers[2].narme 


repository. customers[21.ty pe 


图 10.8 包含 Customer 对 象 的 列表 的 示例 配置 
10.2 使 用 Spring Cloud Zookeeper 


Spring Cloud 文 持 作为 微服 务 架 构 一 部 分 的 各 种 产品 。 例 如 ， 在 阅读 本 章 过 程 中 ， 开 
发 人 员 可 以 将 Consul 与 作为 发 现 工具 的 Eureka 进行 比较 ， 也 可 以 将 Consul 与 作为 分 布 
式 配 置 工具 的 Spring Cloud Config 进行 比较 , 通过 这 种 比较 , 可 以 对 Spring Cloud 所 文 持 
产品 的 丰富 性 有 更 加 深刻 的 认识 。Zookeeper 是 男 一 种 解决 方案 ， 它 可 以 作为 之 前 列 出 的 
产品 的 替代 选择 。 与 Consul 一 样 ， 它 可 用 于 服务 发 现 和 分 布 式 配置 。 要 在 项 目 中 启用 
Spring Cloud Zookeeper， 应 该 包含 用 于 服务 发 现 功能 的 spring-cloud-starter-zookeeper- 
discovery 月 动 器 ， 或 用 于 配置 服务 露 功能 的 spring-cloud-starter-zookeeper-config 局 动 嚣 。 

或 者 ， 开 发 人 员 也 可 以 声明 一 个 spring-cloud-starter-zookeeper-all 依赖 项 ， 它 可 以 激 
活 应 用 程序 的 所 有 功能 。 当 然 ， 也 不 要 扎 记 包含 Spring-boot-starter-web， 因 为 它 仍然 需要 
提供 Web 功能 。 

<dependency> 

<grouplId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-zookeeper-all</artifactId> 


</dependency> 
<dependency> 
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<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
Zookeeper 连接 设置 是 自动 配置 的 ,默认 情况 下 , 客户 端 会 尝试 连接 到 localhost:2181。 
要 窗 新 它 ， 应 该 使 用 当前 服务 器 网 络 地 址 定义 spring.cloud.zookeeper.connect-string 属性 。 
SpIing: 
cloud: 
zzOOkKeeper: 
CoONmeet Streindg: lI92 16 9911000218] 
与 Spring Cloud Consul 一 样 ，Zookeeper 支持 Spring Cloud Netflix 提供 的 所 有 最 流行 
的 通信 库 ， 如 Feign、Ribbon、Zuul 或 Hystrix。 在 开始 处 理 示 例 实 现 之 前 ， 开 发 人 员 必 
须 先 启动 Zookeeper 实例 。 


10.2.1 运行 Zookeeper 


为 简便 起 见 ， 可 以 使 用 Docker 镜像 在 本 地 计算 机 上 启动 Zookeeper。 以 下 命令 将 局 
动 Zookeeper 服务 嚣 实例。 由 于 它 有 快速 失败 (Fails Fast) 机 制 ， 所 以 最 好 的 方法 是 始终 
重新 启动 它 。 


docker run -dd --name zookeeper --restart always -p 2181:2181 zookeeper 


与 先前 讨论 的 在 此 领域 的 解决 方案 (如 Consul 或 Eureka) 相 比 ，Zookeeper 没有 提 
供 简单 的 方便 开发 人 员 管 理 的 RESTful API 或 Web 管理 控制 台 。 它 有 一 个 用 于 Java 和 C 
语言 的 官方 API 绑 定 。 开 发 人 员 也 可 以 使 用 它 的 命令 行 接口 ， 它 可 以 在 Docker 容 句 中 轻 
松 局 动 。 以 下 命令 将 局 动 市 有 命令 行 客 户 问 的 容器 ， 并 可 将 其 链接 到 Zookeeper 服务 句 
容器 。 

docker run -it --rm --l1ink zookeeper: zookeeper zookeeper zkCl1i.sh -server 

zookeeper 

Zookeeper CLI 允许 执行 一 些 有 用 的 操作 ， 如 下 所 示 。 

口 ”创建 znode: 要 使 用 给 定 路 径 创 建 znode， 可 以 使 用 命令 create /path /data。 

口 ”获取 数据 : 命令 get /path 将 返回 与 znode 关联 的 数据 和 元 数据 。 

口 ”观察 更 改 的 znode: 如 果 znode 或 znode 的 子 数 据 发 生 更 改 ， 则 显示 通知 。 观 察 

只 能 使 用 get 命令 设置 。 


口 设置 数据 : 要 设置 znode 数据 ， 可 以 使 用 命令 set /path /data。 
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口 ”创建 znode 的 子 代 : 此 命令 与 用 于 创建 单个 znode 的 命令 类 似 。 唯一 的 区 别 是 子 

znode 的 路 径 将 包括 父 路 径 。 其 命令 格式 为 create /parent /path /subnode /path /data。 

口 ” 列 出 znode 的 子 节点 : 可 以 使 用 ls /path 命令 显示 它 。 

口 检 枉 状态 可 以 使 用 stat /path 命令 检查 。 状 态 将 描述 指定 znode 的 元 数据 ， 如 

时 间 戳 或 版 本 号 。 

口 “删除 /删除 znode: rmr /path 命令 可 以 删除 znode 及 其 所 有 子 节 点 。 

请 注意 ,术语 Zookeeper 节点 (znode) 在 这 里 是 首次 出 现 。 在 存储 数据 时 , Zookeeper 
将 使 用 树 结 构 ， 其 中 每 个 节点 称 为 znode。 这 些 znode 的 名 称 基 于 从 根 节 点 获取 的 路 径 。 
每 个 节点 都 有 一 个 名 称 。 可 以 使 用 从 根 节 点 开始 的 绝对 路 径 访 问 它 。 此 概念 类 似 于 Consul 
文件 夹 ， 并 已 用 于 在 键 / 值 存储 中 创建 键 。 


10.2.2 服务 发 现 


Apache Zookeeper 最 流行 的 Java 客户 端 库 是 Apache Curator。 它 提供 了 一 个 API 框架 
和 实用 程序 ， 使 Apache Zookeeper 的 应 用 变 得 更 加 容易 。 它 还 包括 常见 用 例 和 扩展 ， 如 
服务 发 现 或 Java 8 异步 DSL。Spring Cloud Zookeeper 可 以 利用 一 个 这 样 的 扩展 来 实现 服 
务 发 现 。Spring Cloud Zookeeper 对 Curator 库 的 使 用 对 于 开发 人 员 来 说 是 完全 透明 的 ， 所 
以 在 这 里 就 不 必 做 更 多 的 介绍 。 

1. 客户 痛 实 现 

客户 病 的 用 法 与 其 他 服务 发 现 相关 的 Spring Cloud 项 目 相 同 。 应 用 程序 的 main 类 或 
@Configuration 类 应 使 用 @EnableDiscoveryClient 注解 。 默认 的 服务 名 称 、 实 例 ID 和 站 口 
分 别 取 自 spring.application.name、Spring Context ID 和 server.port。 示 例 应 用 程序 源 代码 
位 于 GitHub 存储 库 (https://github.com/piomin/sample-spring-cloud-zookeeper.git) 中 。 从 
根本 上 说 ， 除 了 Spring Cloud Zookeeper Discovery 依赖 项 之 外 ， 它 与 为 Consul 引入 示例 
系统 没有 什么 不 同 。 它 仍然 由 4 个 微服 务 组 成 ， 这 些微 服务 之 间 可 以 相互 通信 。 现 在 ， 
在 克隆 存 储 库 之 后 ， 可 以 使 用 mvn clean install 命令 构建 它 。 然 后 使 用 java -jar 命令 运行 
具有 活动 配置 文件 名 称 的 每 个 服务 ， 如 java -jar -spring.profiles.active=zonel order-service/ 
target/order-service-1.0-SNAPSHOT.lar。 

可 以 使 用 CLI 命令 ls 和 get 全 看 已 注册 服务 和 实例 的 列表 。 默 认 情 况 下 ,Spring Cloud 
Zookeeper 会 注册 /services 根 文件 夹 中 的 所 有 实例 。 它 可 能 会 被 spring.cloud.zookeeper. 
discovery.root 属性 覆 羡 ， 如 图 10.9 所 示 。 
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图 10.9 ”使 用 带 命 令 行 客户 端的 Docker 容器 检查 当前 已 注册 服务 的 列表 

2. Zookeeper 依赖 项 

Spring Cloud Zookeeper 还 有 一 个 名 为 Zookeeper 依赖 项 (Zookeeper Dependencies) 
的 附加 功能 。 这 里 的 依赖 项 应 理解 为 在 Zookeeper 中 注册 的 其 他 应 用 程序 ， 这 些 应 用 程序 
通过 Feign 客户 端 或 Spring RestTemplate 调用 。 可 以 将 这 些 依赖 项 作为 应 用 程序 的 属性 提 
供 。 在 将 spring-cloud-starter-zookeeper-discovery 启动 器 包含 到 项 目 中 之 后 ， 可 以 通过 目 
动 配置 启用 该 功能 。 当 然 ， 也 可 以 通过 将 spring.cloud.zookeeper.dependency.enabled 属性 
设置 为 false 来 禁用 它 。 

Zookeeper 依赖 项 机 制 的 配置 随 着 spring.cloud.zookeeper.dependencies.* 属 性 一 起 提 
供 。 以 下 是 来 日 order-service 服务 的 bootstrap.yml 文件 的 片段 。 此 服务 可 与 所有 其 他 可 用 


SpIing: 


application: 
name: Order—Service 
Cloud: 
zOOkKeeper: 
connect—string: 192.168.99.100:2181] 
dependency: 
resttemplate: 
enabled: false 
dependencles: 
account: 
path: account—service 
loadBalancerType: ROUND ROBIN 
required: true 
Customer: 
path: customer—service 
loadBalancerType: ROUND ROBIN 
regquired: true 
product: 
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path: product-—service 
loadBalancerType: ROUND ROBIN 


requlred: true 


现在 来 仔细 看 一 看 前 面 的 配置 ,每 个 被 调用 服务 的 root 属 性 是 别名 ,然后 可 以 由 Feign 
客户 病 或 @LoadBalanced RestTemplate 用 作 服 务 名 称 。 


QFeignClient (name = "customer™") 
Public interface CustomerClient 1 


GGetMapping("/withAccounts/{customerId}") 
Customer findByIdWithAccounts (GPathVariable ("customerId") Long 
customerId); 


} 

配置 中 的 下 一 个 非常 重要 的 字段 是 路 径 。 它 设置 在 Zookeeper 中 注册 依赖 项 的 路 径 。 
因此 ， 如 果 该 属性 具有 的 值 为 customer-service， 则 意味 着 Spring Cloud Zookeeper 会 尝 计 
在 路 径 /services/customer-service 下 碍 找 相 应 的 服务 znode。 还 有 一 些 其 他 属性 可 以 目 定义 
客户 端的 行为 。 其 中 之 一 是 loadBalancerType， 用 于 应 用 负载 均衡 策略 。 开 发 人 员 可 以 在 
3 种 可 用 策略 之 间 选 择 一 一 ROUND ROBIN、RANDOM 和 STICKY。 还 可 以 为 每 个 服 
务 映 射 将 required 属性 设置 为 ttue。 现 在 ， 如 果 应 用 程序 在 引导 期 间 无 法 检测 到 所 需 的 
依赖 项 ， 则 无 法 启动 。Sprine Cloud Zookeeper 依赖 项 还 允许 管理 API 版 本 (属性 
contentTypeTemplate 和 versions) 和 请 求 标 头 〈headers 属性 ) 。 

驮 认 情 况 下 ，Spring Cloud Zookeeper 允许 RestTemplate 与 依赖 项 进行 通信 。 在 分 文 
依赖 项 Chttps:Wgithub.comypiomin/sample-spring-cloud-zookeepertree/dependencies ) 提供 的 
示例 应 用 程序 中 ， 我 们 使 用 了 Feign 客户 端 而 不 是 @LoadBalanced RestTemplate。 为 了 禁 
用 该 功能 ,应 该 将 属性 spring.cloud.zookeeper.dependency.resttemplate.enabled 设置 为 false。 


10.2.3 ”分布 式 配 置 


Zookeeper 的 配置 管理 与 Spring Cloud Consul Config 的 配置 管理 非常 相似 。 默 认 情 况 
下 ， 所 有 属性 源 都 存储 在 /config 文件 夹 (或 Zookeeper 术语 中 的 znode) 中 。 如 前 文 所 
述 , 假设 在 bootstrap.yml 文件 中 将 spring.application.name 属性 设置 为 order-service， 并 将 
spring.profiles.active 运行 参数 设置 为 zonel， 那 么 它 会 尝试 按 以 下 顺序 查找 属性 源 : 
config/order-service 、Zonel/、 config/order-service/ 、 config/application 、Zonel/ 、 config/ 


application/。 和 存储 在 命名 空间 中 具有 config/application 前 级 的 文件 夹 中 的 属性 可 用 于 使 用 
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Zookeeper 进行 分 布 式 配 首 的 所 有 应 用 程序 。 

要 访问 示例 应 用 程序 ， 需 要 切换 到 https://github.com/piomin/sample-sprine-cloud- 
zookeeper.git 存储 库 中 的 分 支配 置 。 本 地 application.yml 或 bootstrap.yml 文件 中 定义 的 配 
首 如 下 所 示 ， 现 己 移 至 Zookeeper。 

spring: 

profiles: zonel 


SeTVeT : 
port: ${PORT:8090} 


Spring: 

profiles: Zone2 
Ee 

port: ${PORT:9090} 


必须 使 用 CLI 创建 所 需 的 znode。 如 图 10.10 所 示 的 是 使 用 给 定 路 径 创建 znode 的 
Zookeeper 命令 列表 ， 这 里 使 用 了 create /path /data 命令 。 


[zk: zookeeper(CONNECTED) 11] create Aconf1g “" 

treated /config 

[zk: zookeeper( CONNECTED) 12] create /config/order-service,zonel “" 

treated /config/order-servuice,zonel 

[zk: zookeeper(CONNECTED) 13] create /config/order-service,zonel/server .port 8030 
treated /config/order-servuice,zonel/server .port 

[zk: zookeeper(CONNECTED) 14] create /config/order-servlce,zonez/server .port 30930 


Node does not exist: /config/order-service,zonNe2?/server .port 

[zk: zookeeper(CONNECTED) 15] create 7conflgrorder -Serulce ,zone2 "" 

treated /config/order-service,zonez 

[zk: zookeeper(CONNECTED) 16] create /config/order-service,zone2/server.port 3990930 
treated /config/order-seruice,zone2/server .Port 

[zk: zookeeper( CONNECTED) 17] ls /config 

[order-servuice,zonel, order-servylce,zonez] 


图 10.10 ”使 用 给 定 路 径 创 建 znode 的 Zookeeper 命令 列表 


本 章 介 绍 了 两 个 Spring Cloud 项 目的 主要 功能 一 一 Consul 和 Zookeeper。 虽 然 本 章 的 
重点 不 是 Spring Cloud 功能 ， 但 也 提供 了 有 关 如 何 启 动 、 配 置 和 维护 其 工具 实例 的 说 明 。 
本 章 讨 论 了 更 高 级 的 方案 ， 如 使 用 Docker 设置 由 众多 成 员 组 成 的 集群 。 在 这 些 方 案 中 ， 
开发 人 员 有 机 会 看 到 Docker 作为 开发 工具 的 真正 威力 。 它 允许 开发 人 员 只 使 用 3 个 简单 
命令 初始 化 一 个 由 3 个 成 员 组 成 的 集群 ， 而 无 须 任 何其 他 配置 。 
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在 使 用 Spring Cloud 时 ，Consul 似乎 是 Eureka 作为 发 现 服务 占 的 重要 蔡 代 品 ， 而 对 
于 Zookeeper 则 不 能 作 如 是 观 。 读 者 可 能 已 经 注意 到 了 ， 本 章 对 于 Consul 的 介绍 篇 幅 要 
多 于 Zookeeper。 此 外 ，Spring Cloud 仅 将 Zookeeper 视 为 第 二 选择 ， 因 为 与 Spring Cloud 
Consul 相 比 ，Zookeeper 仍然 没有 分 区 机 制 或 观察 实现 的 配置 更 改 功能 。Consul 是 一 种 现 
代 解 决 方案 ， 则 在 满足 最 新 架构 的 需求 ， 如 基于 微服 务 的 系统 而 Zookeeper 是 一 种 键 / 
值 存 储 ， 用 作 在 分 布 式 环境 中 运行 的 应 用 程序 的 服务 发 现 工具 。 但 是 ， 如 果 在 系统 中 使 
用 Apache Foundation 堆栈 ， 则 值得 考虑 使 用 此 工具 。 由 于 这 一 点 的 存在 ， 开 发 人 员 可 以 
利用 Zookeeper 与 其 他 Apache 组 件 ( 如 Camel 或 Karaf) 之 间 的 集成 ,轻松 发 现 使 用 Spring 
Cloud 框架 创建 的 服务 。 

总 而 言 之 ， 在 阅读 完 本 章 之 后 ， 开 发 人 员 应 该 能 够 在 基于 微服 务 的 架构 中 使 用 Spring 
Cloud Consul 和 Spring Cloud Zookeeper 的 主要 功能 。 开 发 人 员 还 应 该 了 解 Spring Cloud 
中 所 有 可 用 发 现 和 配置 工具 的 主要 优点 和 人 缺 点， 以便 为 系统 选择 最 合适 的 解决 方案 。 
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我 们 已 经 讨论 了 Spring Cloud 提供 的 基于 微服 务 架构 的 许多 功能 。 但 是 ， 我 们 一 直 
在 考虑 的 其 实 都 是 基于 RESTful 的 同步 通信 服务 。 在 本 书 第 1 章 “ 微 服务 简介 ”中 曾经 
提 到 过 ， 还 有 其 他 一 些 流 行 的 通信 方式 ， 如 发 布 /订阅 或 异步 、 事 件 驱动 的 点 对 点 消息 传 
递 等 ， 后 者 就 是 本 章 将 要 介绍 的 一 种 微服 务实 现 方法 ， 它 和 前 面 章 节 所 介绍 的 基于 
RESTful 的 同步 通信 服务 有 所 不 同 。 

本 章 还 将 详细 讨论 如 何 使 用 Spring Cloud Stream 来 构建 消息 驱动 的 微服 务 。 

本 章 将 要 讨论 的 主题 包括 : 

口 与 Spring Cloud Stream 相关 的 主要 术语 和 概念 。 
使 用 RabbitMQ 和 Apache Kafka 消息 代理 作为 绑 定 器 。 
Spring Cloud Stream 编程 模型 。 
绑 定 、 生 成 器 和 使 用 者 的 高 级 配置 。 
扩展 、 分 组 和 分 区 机 制 的 实现 。 


DLL DO L 


11.1 了 解 Spring Cloud Stream 


Spring Cloud Stream 构建 于 Spring Boot 之 上 。 它 允许 开发 人 员 创 建 独立 的 、 生 产 级 
的 Spring 应 用 程序 , 并 使 用 Spring Integration 来 帮助 实现 与 消息 代理 的 通信 。 使 用 Spring 
Cloud Stream 创建 的 每 个 应 用 程序 都 可 以 通过 输入 和 输出 通道 与 其 他 微服 务 集成 。 

这 些 通道 通过 与 中 间 件 相关 的 绑 定 器 (Binder) 实现 连接 到 外 部 消息 代理 。 有 两 种 内 
置 的 绑 定 器 实现 一 一 Kafka 和 Rabbit MQ。 

Spring Integration 扩展 了 Spring 编程 模型 ， 以 文 持 人 欢 所 周知 的 企业 集成 模式 

(Enterprise Integration Patterns，EIP)〉。EIP 定义 了 许多 通常 用 于 分 布 式 系统 中 的 协作 的 组 

件 。 读 者 可 能 已 经 听 说 过 消息 通道 、 路 由 器 、 聚 合 器 或 端点 等 模式 。Spring Integration 框架 
的 主要 目标 是 提供 一 个 基于 EIP 构建 Spring 应 用 程序 的 简单 模型 。 如 果 读 者 对 有 关 EIP 
的 更 多 详细 信息 感 兴 趣 ， 请 访问 网 站 http:Wwww.enterpriseintegrationpatterns.comypatterns/ 
messaging,/toc.html。 
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11.2 构建 消息 传递 系统 


我 们 认为 引入 主要 Spring Cloud Stream 功能 的 最 合适 方式 是 通过 基于 微服 务 的 示例 
系统 。 我 们 将 轻松 修改 前 面 章节 中 讨论 过 的 系统 架构 。 这 里 不 妨 简 要 回顾 一 下 这 种 架构 。 
我 们 的 系统 狐 责 处 理 订 单 。 它 由 4 个 独立 的 微服 务 组 成 。order-service 微服 务 首 先 与 
product-service 服务 进行 通信 ， 以 便 收 集 所 选 产品 的 详细 信息 ， 然 后 通过 customer-service 
服务 来 检索 有 关 客 户 及 其 账户 的 信息 。 现 在 ， 发 送 到 order-service 服务 的 订单 将 被 异步 处 
理 。 此 时 仍 有 一 个 公开 的 RESTful HTTP API 端点 用 于 客户 端 提交 新 订单 ,但 应 用 程序 不 
会 处 理 它 们 。 它 只 保存 新 订单 ， 将 其 发 送 到 消息 代理 ， 然 后 给 客户 端 发 送 啊 应 ， 表 示 订 
单 己 被 批准 处 理 。 当 前 讨论 的 示例 的 主要 目标 是 显示 点 对 点 通信 ， 因 而 消息 将 仅 由 一 个 
应 用 程序 (account-service 服务 ) 接收 。 图 11.1 说 明了 这 个 示例 系统 的 架构 。 


图 11.1 示例 系统 的 架构 


收 到 新 消 恩 之 后 ，account-service 服务 会 调用 product-service 公开 的 方法 以 查找 其 价 
格 。 它 从 账户 中 提取 资金 , 然后 将 啊 应 发 送 回 order-service 服务 (包含 当前 订单 的 状态 )。 
该 消息 也 通过 消息 代理 有 发送 。order-service 微服 务 将 接收 消息 并 更 新 订单 状态 。 如 果 外 部 
客户 端 想 要 检查 当前 订单 状态 , 它 可 以 调用 公开 find 方法 的 端点 ， 查 找 订 单 的 详细 信息 。 
该 示例 应 用 程序 的 源 代码 可 在 GitHub (https://github.com/piomin/sample-sprine-cloud- 
messasging.git) 上 获得 。 


11.2.1 局 用 Spring Cloud Stream 


在 项 目 中 包含 Spring Cloud Stream 的 推荐 方法 是 使 用 依赖 项 管理 系统 。Spring Cloud 
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Stream 具有 与 整个 Spring Cloud 框架 相关 的 独立 版 本 列车 管理 。 人 但是， 如果 在 
dependencyManagement 部 分 的 Edgware.RELEASE 版 本 中 声明 了 spring-cloud-dependencies， 
那么 就 不 必 在 pom.xml 中 声明 任何 其 他 内 容 。 如 果 开 发 人 员 只 想 使 用 Spring Cloud Stream 
项 目 ， 则 应 定义 以 下 部 分 。 
<dependencyManagement> 
<dependencies> 
<dependency> 
<gqroupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-stream-dependencies</artifactId> 
<Version>Ditmars.SR2</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


下 一 步 是 将 spring-cloud-stream 添加 到 项 目 依赖 项 中 。 此 外 ， 建 议 开 用 人员 至 少 包 含 
spring-cloud-sleuth 库 ， 以 提供 发 送 消息 功能 和 traceIld， 这 个 traceld 与 通过 Zuul 网 关 传 入 
order-service 服务 的 源 请 求 的 traceld 相同 。 

<dependency> 

<groupId>org .springframework.cloud</grouplId> 
<artifactIid>spring-cloud-stream</artifactId> 

</dependency> 

<dependency> 

<gqroupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-sleuth</artifactId> 

</dependency> 

要 为 应 用 程序 局 用 与 消息 代理 的 连接 ， 请 使 用 @EnableBinding 注解 主 类 。 
@EnableBinding 注解 可 以 将 一 个 或 多 个 接口 作为 参数 。 可 以 在 Spring Cloud Stream 提供 
的 3 个 接口 之 间 选 择 。 

口 ”Sink: 用 于 标记 从 入 站 通道 接收 消息 的 服务 。 

口 。”Source: 用 于 癌 出 站 频道 发 送 消 明 。 

口 ”Processor: 可 用 于 需要 入 站 通道 和 出 站 通道 的 情况 , 因为 它 扩 展 了 Source 和 Sink 
接口 。 由 于 order-service 服务 发 送 消息 以 及 接收 消息 ， 因 而 其 主 类 已 使 用 
@EnableBinding (Processor.class) 进行 注解 。 

以 下 是 文 持 Spring Cloud Stream 绑 定 的 主要 order-service 服务 类 。 
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QSpringBootApplication 
QEnableDiscoveryClient 
QEnableBinding (Processor.class) 
public class OrderApplication 1 


public static void main(string[l|] args) 1 
new 
SpringApplicationBuilder (OrderApplication.class) .web (true) .run(args)}); 


} 


11.2.2 ”声明 和 绑 定 频道 


由 于 使 用 了 Spring Integration， 因 而 该 应 用 程序 独立 于 项 目 中 包含 的 消息 代理 实现 。 
Spring Cloud Stream 将 目 动 检测 并 使 用 类 路 径 中 找到 的 绑 定 器 , 这 意味 着 开发 人 员 可 以 选 
择 不 同类 型 的 中 间 件 ， 并 配合 相同 的 代码 使 用 。 所 有 与 中 间 件 相关 的 设置 都 可 以 通过 外 
部 配置 属性 覆盖 ， 并 且 采 用 Spring Boot 支持 的 形式 ， 如 应 用 程序 参数 、 环 境 变 量 或 
application.yml 文件 。 

如 前 文 所 述 ，Spring Cloud Stream 为 Kafka 和 Rabbit MQ 提供 了 绑 定 圳 实现。 要 包含 
对 Kafka 的 文 持 ， 请 将 以 下 依赖 项 添加 到 项 目 中 。 

<dependency> 

<gqroupId>org .springframework.cloud</grouplId> 
<artifactIid>spring-cloud-starter-stream-—kafka</artifactId> 
</dependency> 


就 个 人 而 言 ， 笔 者 更 喜欢 RabbitMQ， 本 章 将 为 RabbitMQ 和 Kafka 各 创建 一 个 示例 。 由 
于 前 面 的 章节 已 经 讨论 过 RabbitMQ 的 功能 ， 所 以 现在 就 先 从 基于 RabbitMQ 的 示例 开始 。 
<dependency> 
<groupId>org.springframework.cloud</grouplId> 
<artifactIid>spring-cloud-starter-stream-—rabbit</artifactId> 
</dependency> 
启用 Spring Cloud Stream 并 包含 绑 定 器 实现 后 ， 即 可 创建 发 送 消 奶 者 (Sender) 和 侦 
上 听 消 县 者 〈Listener) 。 现 在 可 以 从 负责 癌 代 理发 送 新 订单 消 恩 的 生产 者 (Producer) 开 
始 。 这 是 通过 order-service 中 的 OrderSender 实现 的 ， 它 使 用 Output bean 发 送 消 思 。 


QService 
Public class Ordersender I 


第 11 章 消息 驱动 的 微服 务 * 7273。 


QAutowired 
private SOurce SOUurcer 


public boolean sendl{Order order) 1{ 
return 
this.source.output(} .send(lMessageBuilder.withPayload (order}) .build())}); 


} 


} 
该 bean 由 控制 右 调 用 ， 它 公开 允许 提交 新 订单 的 HTTP 方法 。 


QRestController 
public class OrderController | 


private static final Logger LOGGER = 
LoggerFactory.getLogger (OrderController.class)}); 
private ObjectMapper mapper = new ObjectMapper (); 


@Autowired 

OrderRepository repository; 
Autowired 

OrderSender sender; 


@PostMapping 
public Order process (RequestBody Order order) throws 
JsonProcessingException | 
Order oO = repository.add (order); 
LOGGER .info("Order saved: {}", mapper.writeValueAsString (order) ) : 
boolean isSent = sender.send(o):; 
LOGGER.infol("Order sent: {}", 
mapper .writeValueAsString(Collections.singletonMap("isSent™”, lsSent})})}); 
return or 


} 


包含 订单 信息 的 消息 已 发 送 到 消息 代理 。 现 在 , 它 应 该 通过 account-service 服务 接收 。 
要 完成 这 一 操作 ， 必 须 声 明 接 收 匿 ， 接 收 圳 将 侦 听 传 入 队列 的 消息 ， 这 个 消息 是 在 消 奶 
代理 上 创建 的 。 要 接收 融 有 订单 数据 的 消 四 ， 只 需要 使 用 @StreamListener 注解 让 该 方法 
采用 Order 对 象 作为 参数 。 
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QSpringBootApplication 
QEnableDiscoveryClient 
QEnableBinding (Processor.class) 
public class AccountApplication | 


RAutowired 
AccountService service; 


public static void main(Stringl[l] args) 1 
new 
SpringApplicationBuilder (AccountApplication.class) .Web (true) .run(args}); 


} 


&Bean 

dSstreamListener (Processor .INPUT) 

Public void receliveOrder (Order order) throws JsonProcessingException 1{ 
SeErLVICe-DrIOCeESss (Order}s 


} 


现在 可 以 局 动 示 例 应 用 程序 。 但 是 ， 这 里 还 有 一 个 尚未 提 及 的 重要 细节 。 这 两 个 应 
用 程序 都 尝试 连接 在 a 上 运行 的 RabbitMQ, 并 且 它 们 都 将 相同 的 交换 (Exchange) 
信息 视 为 输入 或 输出 .这 是 一 个 问题 , 因为 order-service 服务 将 消 四 发送 到 输出 交换 信息 ， 
而 account-service mm 听 传 入 其 输入 交换 消息 。 这 些 是 不 同 的 交换 信息 ,但 先 者 恒 
先 。 接 下 来 不 妨 藉 从 运行 消息 代理 开始 。 


11.2.3” 自 定义 与 RabbitMQ 代理 的 连接 


在 前 面 的 章节 中 ， 已 经 介绍 了 使 用 Docker 镜像 启动 RabbitMQ 代理 的 方法 ， 因 而 有 
必要 记 住 这 个 命令 。 它 将 启动 一 个 带 RabbitMQ 的 独立 Docker 容器 ,可 在 端口 5672 下 使 
用 ， 其 用 户 界面 Web 控制 台 可 在 端口 15672 下 使 用 。 

docker run -d --name rabbit -p 15672:15672 -p 5612:5672 rabbitmgq:management 

应 使 用 application.yml 文件 中 的 spring.rabbit.* 属 性 覆盖 默认 的 RabbitMQ 地 址 。 

SpIring: 

rabbitma : 
host: 192.168.99.100 
port: os612 
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默认 情况 下 ，Spring Cloud Stream 会 为 通信 创建 主题 交换 信息 。 这 种 类 型 的 交换 更 适 
合 发 布 /订阅 交互 模型 。 开 发 人 员 也 可 以 使 用 exchangeType 属性 覆盖 它 ， 就 像 在 
application.yml 的 片段 中 一 样 ， 如 下 所 示 。 
SpIing: 
Cloud: 
stream: 
rabbit: 
bindings: 
output: 
producer: 
exchangeType: direct 
lnput: 
Consumer: 
exchangeType: direct 
开发 人 员 应 该 为 order-service 服务 和 account-service 服务 提供 相同 的 配置 设置 。 这 里 
不 必 手 动 创建 任何 交换 信息 。 如 果 它 不 存在 ， 则 它 会 在 启动 期 间 由 应 用 程序 自动 创建 。 
否则 ， 应 用 程序 只 会 绑 定 到 该 交换 信息 。 默 认 情 况 下 ， 它 创建 交换 信息 时 所 使 用 的 名 称 ， 
对 于 @Input 通道 就 是 输入 的 名 称 ， 对 于 (@Output 通道 就 是 输出 的 名 称 。 这 些 名 称 可 以 用 
spring.cloud.stream.bindings.output.destination 和 spring.cloud.stream.bindings.input.destination 
属性 覆盖 ， 其 中 的 输入 和 输出 都 是 通道 的 名 称 。 此 配置 选项 不 仅 是 Spring Cloud Stream 
功能 的 一 个 很 好 的 补充 ， 而 且 是 用 于 关联 服务 间 通 信 中 的 输入 和 输出 目标 的 键 值 设 置 。 
要 解释 为 什么 会 发 生 这 种 情况 也 非常 简单 。 在 我 们 的 示例 中 ， 一 方面 ，order-service 是 消 
息 源 应 用 程序 ， 因 而 它 会 将 消息 发 送 到 输出 通道 。 然 后 ， 另 一 方面 ，account-service 服务 
将 侦 昕 输入 通道 上 的 传 入 消息 。 如 果 order-service 服务 的 输出 通道 和 account-service 服务 
的 输入 通道 未 引用 代理 上 的 相同 目标 ， 则 它们 之 间 的 通信 将 失败 。 总 之 ， 我 们 决定 使 用 
名 称 为 order-out 和 orders-in 的 目的 地 ， 并 且 为 order-service 服务 提供 了 以 下 配置 。 
spring: 
cloud: 
stream: 
bindings: 
output: 
destinatijon: orders—out 
input: 
destinatijon: orders—1in 


account-service 服务 的 类 似 配置 设置 则 刚好 相反 。 
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SPpIing: 
cloud: 
stream: 
bindings: 
output: 
destination: orders-—in 
input: 


destination: orders-out 
在 两 个 应 用 程序 都 启动 之 后 ， 可 以 使 用 其 Web 管理 控制 台 轻 松 查 看 RabbitMQ 代理 
上 声明 的 交换 列表 ， 该 控制 台 位 于 http://192.168.99.100:15672 (guest/euest) 。 如 图 11.2 
所 示 的 是 隐 式 创建 的 交换 信息 (Exchange) ， 开 发 人 员 可 能 会 看 到 出 于 测试 目的 创建 的 
两 个 目标 。 


bg R a 0 b ] { 3.65.14 Erlang 19.2.1 


Dverview Conmections Channels Exchanges Dueues Admin 


Exchanges 
All exchanges (10} 


Pagination 


page|1 ~ | of 1 - Filter: 国 Regex 车 


Nare TYWpe Features Message rate in Message rate out +/- 


(CAMOP default) direct D 
anmgq.direct direct D 
amq.fanout fanout D 
amq.headers headers D 
amgq.rmatch headers 
anmgq.rabbitmagq.log topic 
amgq.rabbitmq.trace topic 
amdgq.topic topic 
orders-in direct 


orders-out diredtt 


图 11.2 查看 RabbitMQ 代理 上 声明 的 交换 列表 


驮 认 情 况 下 ，Spring Cloud Stream 将 提供 一 个 输入 和 一 个 输出 消息 通道 。 可 以 想象 一 
种 情况 ， 即 我 们 的 系统 需要 为 每 种 类 型 的 消息 通道 提供 多 个 目的 地 。 现 在 可 以 回 到 示例 


第 11 章 消息 驱动 的 微服 务 。227。 


系统 架构 ， 并 考虑 每 个 订单 由 另外 两 个 微服 务 异 步 处 理 的 情况 。 到 目前 为 止 ， 只 有 
account-service 服务 一 直 在 监听 来 自 order-service 服务 的 传 入 事件 。 在 当前 示例 中 ， 
product-service 服务 将 是 传 入 订单 的 接收 者 ， 它 在 这 种 情况 下 的 主要 目标 是 管理 可 用 产品 
的 数量 , 并 根据 订单 细节 减少 它们 。 它 要 求 我 们 在 order-service 服务 中 定义 两 个 输入 和 和 输 
出 消息 通道 , 因为 我 们 仍然 有 基于 直接 RabbitMQ 交换 信息 的 点 对 点 通信 , 其 中 每 个 消息 
都 可 以 由 一 个 使 用 者 处 理 。 

在 这 种 情况 下 ， 我 们 应 该 使 用 @Input 和 人 @Onutpnut 方法 声明 两 个 接口 。 每 个 方法 都 必 
须 返 回 一 个 channel 对 象 。Spring Cloud Stream 提供 两 个 可 绑 定 的 消息 组 件 一 一 用 于 出 站 
通信 的 MessageChannel， 以 及 它 的 扩展 一 一 用 于 入 站 通信 的 SubscribableChannel。 这 是 与 
product-service 服务 交互 的 接口 定义 。 己 创建 用 于 通过 account-service 服务 进行 消息 传递 
的 类 似 接口 。 


public interface ProductOrder 1 


@Input 
SubscribableChannel productOrdersIn(); 


@Ooutput 
MessageChannel productoOrdersOut () : 

} 

下 一 步 是 通过 使 用 @EnableBinding(value={AccountOrder.class,ProductOrder.class}) 来 
注解 其 主 类 以 激活 应 用 程序 的 声明 组 件 。 现 在 ， 可 以 使 用 它们 的 名 称 在 配置 属性 中 引用 
这 些 通道 , 如 spring.cloud.stream.bindings.productOrdersOut.destination=product-orders-in。 使 用 
@Input 和 @Output 注解 时 ， 可 以 通过 指定 通道 名 称 来 日 定义 每 个 通道 名 称 ， 示 例如 下 。 


public interface ProductOrder 1 


@Input ("productoOrdersIn") 
SubscribableChannel ordersIn(); 


aoutput ("productordersout™") 
MessageChannel ordersOut (}); 


} 
基于 上 自 定 义 接口 声明 ，Spring Cloud Stream 将 生成 实现 该 接口 的 bean。 但是， 仍然 必 


须 在 负责 发 送 消 恩 的 bean 中 访问 它 。 与 前 面 的 示例 相 比 ， 直 接 注 入 绑 定 通道 会 更 简便 。 
以 下 是 当前 产品 订单 消息 发 送 者 的 bean 实现 。 还 有 一 个 类 似 的 bean 实现 , 它 可 以 将 消息 
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上 肥大 到 account-service。 


QService 
Public class ProductOrderSender 1 


RAutowired 
private MessageChannel output; 
@Autowired 
public SendingBean (Qualifier ("productOrdersOut") MessageChannel 
output)} 1 
this.output = output; 
} 


Public boolean sendl(Order order}) 1 
return this.output.send (MessageBuilder.withPayload (order) .build(}); 
} 


} 


还 应 为 目标 服务 提供 每 个 消 明 通道 的 目 定 义 接 口 。 侦 听 消 奶 者 应 绑 定 到 消 明 代理 上 
的 正确 消息 通道 和 目标 。 

astreamListener (ProductoOrder.INPUT) 

Pub11c Yold receiveOrder (Order order) throws JsonProcessingException 1 


Service-.DProcess (order}s 


} 


11.2.4 与 其 他 Spring Cloud 项 目 集成 


你 可 能 已 经 注意 到 ， 示 例 系统 混合 了 不 同类 型 的 服务 间 通 信 。 有 些微 服务 使 用 典型 
的 RESTful HTTP API， 还 有 一 些 使 用 消 恩 代理 。 在 单个 应 用 程序 中 混合 不 同类 型 的 通信 
也 没有 异议 。 例如， 可 以 使 用 Spring Cloud Stream 将 spring-cloud-starter-feign 包含 在 项 目 
中 ， 并 使 用 @EnableFeignClients 注解 启用 它 。 在 我 们 的 示例 系统 中 ， 这 两 种 不 同 的 通信 
方式 结合 了 account-service 服务 , 它 通 过 消息 代理 与 order-service 服务 集成 ,并 通过 REST 
API 与 product-service 服务 集成 。 以 下 是 account-service 服务 模块 中 Feign 客户 疹 的 
product-service 服务 实现 。 

QFeignClient (name = "product-service") 


Public interface ProductClient 1 
@PostMapping("/ids") 
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List<Product> findqByIds (RequestBody List<Long> ids); 

} 

还 有 其 他 好 消 忠 。 由 于 Spring Cloud Sleuth 的 存在 ,在 通过 网 关 传 入 系统 的 单个 请 求 
期 间 交 换 的 所 有 消息 都 具有 相同 的 traceId。 无 论 是 同步 REST 通信 还 是 异步 消息 传递 ， 
开发 人 员 都 可 以 使 用 标准 日 志文 件 或 日 志 聚 合 右 工具 (如 Elastic Stack) 轻松 跟踪 和 关联 
微服 务 之 间 的 日 志 。 

现在 是 运行 和 测试 示例 系统 的 好 时 机 。 首 先 ， 开 发 人 员 必 须 使 用 mvn clean install 命 
令 构 建 整 个 项 目 。 要 使 用 两 个 微服 务 来 侦 听 两 个 不 同 交 换 上 的 消息 来 访问 代码 示例 ， 开 
发 人 员 应 该 切换 到 advanced 分 支 (https://github.conypiomin/sample-spring-cloud-messaging/ 
tree/advanced) 。 应 该 启动 其 中 可 用 的 所 有 应 用 程序 一 一 网 关 、 发 现 和 3 个 微服 务 

(account-service 服务 、order-service 服务 、product-service 服务 ) 。 目 前 讨论 的 案例 假设 

我 们 还 使 用 其 Docker 容 右 启动 了 RabbitMQ、Logstash、Elasticsearch 和 Kibana。 有 关 如 
何 使 用 Docker 镜像 在 本 地 运行 Elastic Stack 的 详细 说 明 ， 请 参阅 本 书 第 9 章 “ 分 布 式 日 
志 记 录 和 跟踪 ”。 图 11.3 详细 显示 了 本 示例 系统 的 架构 。 


RabbitMQ 消息 代理 


i 


product-orders-out 上 


图 11.3 示例 系统 的 架构 
运行 所 有 必需 的 应 用 程序 和 工具 后 ， 即 可 继续 进行 测试 。 以 下 是 示例 请 求 ， 它 可 以 


通过 API 网 关 发 送 到 order-service 服务 。 
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curl -H "Content-Type: application/json" -X POST -d 
'{"customerId"™:1,"productIds": [1,3,4] ,"status"™: "NEW"}' 
http://localhost:8080/api/order 


如 果 按 照 前 文 所 述 配 置 的 应 用 程序 运行 测试 时 ， 第 一 次 可 能 无 法 正常 工作 。 有 些 开 
发 人 员 可 能 会 有 点 困惑 ， 因 为 通常 它 是 在 默认 设置 下 测试 的 。 要 让 它 正确 运行 ， 还 必须 
在 application.yml 中 添加 以 下 属性 : spring.cloud.stream.rabbit.bindings.output.producer. 
routingKeyExpression:"#"。 它 可 以 将 默认 生产 者 的 路 由 键 设置 为 与 应 用 程序 引导 期 间 日 
动 创建 的 交换 信息 的 路 由 键 一 致 。 在 如 图 11.4 所 示 的 屏幕 截图 中 ， 可 能 会 看 到 一 个 输出 
交换 信息 定义 。 


区 = Ra obit 3.6,1494 Erlang 19.2,1 


Overview Connections Channels Exchanges Queues Admin 


Exchange: orders-out 
” Overview 
Message rates last minute ? 
Currantly idle 
Details 
Type | direct 
Featuras durable: true 


Policy 
Bindings 
This exchange 
Routing kay Arguments 


- unbind | 


11.4 其 中 的 一 个 输出 交换 信息 


在 执行 上 述 修改 之 后 ， 应 该 能 成 功 完成 测试 。 微 服务 打印 的 日 志 通 过 traceld 相互 天 
联 。 我 们 在 logback-spring.xml 中 稍微 修改 了 默认 的 Sleuth 日 志 记 录 格 式 ， 这 束 是 现在 配 
置 的 方式 %d {HH:mm:ss.SSS19%0-Slevel [%X {X-B3-Traceld: - } ,%X {X-B3-Spanld: 
- }] %msg%n。 在 发 送 测试 性 的 order-service 服务 测试 请 求 后 ， 日 志 将 记录 以 下 信息 。 

12:34:48.696 INFO [68038cdad653t 1b0b,68038cdd653f/b0b| Order saved: 


1 " id”:1, "status” :" "NEW, price™ :0, customerId :1, "accountIid :nall., 
“Droduactld s":|[1,3;4|]1} 
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12:34:49.821 INFO [68038cdadd653t7bob ,68038cadq653ft7bob]l Crader sent: 
{"ijsSsent™ :truel} 


可 以 看 到 ，account-service 服务 也 使 用 相同 的 日 志 记 录 格 式 ， 并 打印 与 order-service 
服务 相同 的 traceld。 


12:34:50.019 INEO [68038cadd6o53 /bob ,23432Q962eco2 /al Order processed: 
站 王 晶 ”> 了 与 二 二 七 下 号 2: "NEW Price” :0 customertid :1 accountrd :nullt, 
"Pouctid | 

12:34:50.332 INEO [68038cdd653f7b0b,23432d962ec92fial Account found: 
{"id":1, "number™”:" 12345061890™", balance- :50000 "customerld™”:11 
12:34:52.344 INEO [68038cdd653f'71b0b,23432d962ec92f /al Products found: 
[iid"”:1, name”: “Testl" "price :1000};. {id :3, "name :Test3"., 

"PELCe :2000},{"id":4, name : ITest4 ”PITLCe :30001}] 


可 以 使 用 Elastic Stack 聚合 在 单个 事务 期 间 生 成 的 所 有 日 志 。 可 以 通过 X-B3-TraceId 
字段 (如 9dale5c83094390d) 过 滤 条 目 ， 如 图 11.5 所 示 。 


图 11.5 ” 襄 合 日 志 
11.3 发 布 /订阅 模型 


事实 上 ， 创 建 Spring Cloud Stream 项 目的 主要 动机 是 支持 持久 的 发 布 /订阅 模型 。 在 
前 面 的 小 节 中 ， 我 们 讨论 了 微服 务 之 间 的 点 对 点 通信 ， 这 只 是 一 个 附加 功能 。 但 是 ， 无 
论 我 们 是 否决 定 使 用 点 对 点 通信 或 发 布 /订阅 模型 ， 编 程 模型 仍然 是 相同 的 。 

在 发 布 /订阅 通信 中 ， 数 据 通 过 共享 主题 广播 。 它 降低 了 生产 者 (Producer) 和 使 用 
者 “Consumer) 的 复杂 性 ， 并 允许 将 新 应 用 程序 轻松 添加 到 现 有 拓扑 中 ， 而 无 须 对 流程 
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进行 任何 更 改 。 这 可 以 在 最 后 提供 的 系统 示例 中 清楚 地 看 到 ， 在 该 系统 中 ， 我 们 决定 添 
加 第 二 个 应 用 程序 ， 它 将 使 用 源 微服 务 生 成 的 事件 。 与 初始 染 构 相 比 ， 开 发 人 员 必 须 定 
义 专 用 于 每 个 目标 应 用 程序 的 目 定 义 消 恩 通道 。 通 过 队列 直接 通信 ， 消 恩 只 能 由 一 个 应 
用 程序 实例 使 用 ， 因 此 ， 解 决 方案 是 必要 的 。 发 布 /订阅 模型 的 使 用 简化 了 该 架构 。 


11.3.1 运行 示例 系统 


要 开发 采用 发 布 /订阅 模型 的 示例 应 用 程序 ， 比 开发 采用 点 对 点 通信 的 示例 应 用 程序 
更 简单 。 开 发 人 员 不 必 禾 盖 任 何 默 认 消 晨 通 道 以 启用 与 多 个 接收 器 的 交互 。 与 演示 问 单 
个 目标 应 用 程序 (account-service 服务 ) 传递 消息 的 初始 示例 相 比 ， 这 里 只 需要 稍微 修改 
一 下 配置 设置 。 由 于 Spring Cloud Stream 默认 绑 定 到 主题 ， 因 而 不 必 为 输入 冰 上 息 通 拓 履 
新 exchangeType。 正 如 以 下 配置 片段 所 示 ， 我 们 仍然 在 将 啊 应 发 送 到 order-service 服务 
时 使 用 点 对 点 通信 。 如 果 认 真 思考 一 下 就 会 发 现 ， 这 上 自 有 其 道理 。order-service 微服 务 发 
送 的 消息 必须 由 account-service 服务 和 product-service 服务 接收 ， 而 来 自 它们 的 啊 应 仅 针 
对 order-service 服务 。 


SpI1ing: 
application: 
name: Product—service 
rabbitmg: 
st ld ED 
port: v612 
cloud: 
stream: 
bindings: 
output: 
destination: oOrders—1n 
input: 
destination: orders—out 
rabbit: 
bindings: 
output: 
producer: 
exchangeType: direct 
routingKeyExpression: '"'"#"" 


product-service 服务 的 主要 处 理 方法 的 逻辑 非常 简单 。 它 只 需要 从 收 到 的 订单 中 找到 
所 有 的 productId， 更 改 每 个 产品 的 库存 数量 ， 然 后 将 啊 应 发 送 到 order-service 服务 。 
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QAutowired 

ProductRepository productRepository; 
QAutowired 

OrderSender orderSender; 


Public Vold process (final Order order) throws JsonProcessingException 1 
LOGGER.infol(" "Order processed: {|}", mapper.writeValueAsString (order})}:; 
for (Long product1Id : order.getProductIds(}} 1{ 

Product product = productRepository.findBylId (product1Id).; 


if (product.getcCount(})} == 0) 1{ 
order.setStatus (Orderstatus .REJECTED); 
break; 

} 

product .setCount (product .getcount(} 一 工 ) ; 


productRepository.update (product)}); 
LOGGER. info("Product updated: {}", 
mapper.writeValueAsSstring (product) ) ， 

} 

1if (order .GetStatus () != OrderStatus .REJECTED) { 

order.setsSstatus (OrderSstatus .ACCEPTED)}; 

} 

LOGGHR 1nfoGt Order TeSPOnNnse Sen (1 
mapper.writeValueAsstring(Collections.singletonMap ("status"™, 
order.getstatus ()))); 

orderSender.sendl(order}); 


} 


要 访问 当前 示例 ， 只 需 切 换 到 publish subscribe 分 支 ， 这 可 从 https://github.cony 
piomin/sample-spring-cloud-messaging/tree/publish_ subscribe 获取 。 然 后 ， 开 发 人 员 应 该 构 
建 父 项 目 并 运行 与 上 一 个 示例 相同 的 所 有 服务 。 如 果 想 要 让 测试 一 切 正 常 ， 直 到 只 有 一 
个 正在 运行 的 account-service 服务 和 product-service 服务 实例 ， 那 么 现在 就 可 以 来 讨论 这 
个 问题 。 


11.3.2 扩展 和 分 组 


在 谈论 基于 微服 务 的 架构 时 ， 可 伸缩 性 〈Scalability) 始终 是 其 主要 优势 之 一 。 通 过 
创建 给 定 应 用 程序 的 多 个 实例 来 扩展 系统 的 站 ee 执行 此 操作 时 ， 应 用 程序 的 
不 同 实例 将 放置 在 竞争 的 使 用 者 关系 中 ， 其 中 只 有 一 个 实例 需要 处理 给 定 的 消 恩 。 可 
点 对 点 通信 来 说 ， 这 不 是 问题 ， 但 在 上 发布 - 订 ed 肖 奶 会 被 所 有 接收 者 使 用 ， 这 可 
能 是 一 个 挑战 。 
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1. 运行 多 个 实例 
扩展 微服 务实 例 数量 的 可 用 性 是 Spring Cloud Stream 的 主要 概念 之 一 。 然 而 ， 这 个 
想法 背后 没有 神奇 的 地 方 。 使 用 Spring Cloud Stream 可 以 非常 轻松 地 运行 应 用 程序 的 多 
个 实例 。 其 中 一 个 原因 是 来 自 消 息 代 理 的 原生 支持 ， 它 骨 在 处 理 许多 使 用 者 和 大 量 流量 。 
在 这 种 情形 下 ， 所 有 消息 传递 微服 务 也 将 公开 RESTful HTTP API， 因 此 ， 首 先 必 须 
为 每 个 实例 定制 服务 器 应 口 。 我 们 之 前 已 经 进行 了 此 类 操作 。 还 可 以 考虑 设置 两 个 Spring 
Cloud Stream 属性 spring.cloud.stream.instanceCount 和 spring.cloud.stream.instanceIndex。 
多 亏 了 它们 ， 微 服务 的 每 个 实例 都 能 够 接收 有 关 同 一 应 用 程序 的 其 他 几 个 示例 的 局 动 信 
恩 以 及 它 上 自己 的 实例 索引 。 仅 当 要 局 用 分 区 功能 时 ， 才 需要 正确 配置 这 些 属 性 。 下 文 很 
快 将 谈论 这 个 机 制 。 现 在 ， 让 我 们 来 看 一 看 扩展 应 用 程序 的 配置 设置 。account-service 服 
务 和 product-service 服务 都 定义 了 两 个 配置 文件 , 用 于 运行 应 用 程序 的 多 个 实例 。 我们 已 
经 自 定 义 了 服务 器 的 HTTP 端口 、 实 例 的 数量 和 索引 。 
SpIring: 
Profiles: Tnstancel 
cloud: 
stream: 
instanceCount: 2 
instancelIndex: 0 


SELEVEOEL.: 
port: ${PORT:8091} 


SpI1ing: 
profiles: linstance2 
cloud: 
stream: 
instanceCount: 2 
instancelIndex: 1 
SeTVeT : 
port: ${PORT:9091]) 


构建 父 项 目 后 ， 开 发 人 员 可 以 运行 该 应 用 程序 的 两 个 实例 。 它 们 中 的 每 一 个 都 使 用 
分 配给 在 局 动 期 间 传递 的 正确 配置 文件 的 属性 进行 初始 化 ， 如 java -jar --spring.profiles. 
active=instancel target/account-service-1.0-SNAPSHOT.jar。 如 果 问 order-service 服务 端点 
POST / 发 送 测试 请 求 ， 则 新 订单 将 转发 到 RabbitMQ 主题 交换 信息 ， 以 便 由 连接 到 该 交 
换 的 account-service 服务 和 product-service 服务 接收 。 现 在 的 问题 是 每 个 服务 的 所 有 实例 
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都 收 到 消息 ， 这 并 不 是 我 们 想 要 实现 的 。 要 解决 这 个 问题 ， 分 组 机 制 可 以 带 来 帮助 。 

2. 使 用 者 分 组 

我 们 的 目的 很 明确 。 现 在 有 许多 微服 务 使 用 来 目 同一 主题 的 消 轧 。 应 用 程序 的 不 同 
实例 被 置 于 竞争 的 使 用 者 关系 中 ， 但 只 有 其 中 一 个 应 该 处 理 给 定 的 消息 。Spring Cloud 
Stream 引入 了 模拟 此 行为 的 使 用 者 分 组 (Consumer Group ) 的 概念 。 要 激活 此 类 行为 ， 
我 们 应 该 使 用 组 名 设置 为 spring.cloud.stream.bindings.<channelName>.group 的 属性 。 设置 
之 后 ， 订 阅 给 定 目标 的 所 有 分 组 都 会 接收 到 已 发 布 数据 的 副本 ， 但 每 个 组 中 只 有 一 个 成 
员 接 收 并 处 理 来 目 该 目标 的 消息。 在 我 们 的 示例 中 ， 有 两 个 分 组 。 第 一 个 是 具有 名 称 账 
户 的 所 有 account-service 服务 实例 的 分 组 ; 第 二 个 则 是 具有 名 称 产 品 的 product-service 服 
务实 例 的 分 组 。 

以 下 是 account-service 服务 的 当前 绑 定 配置 。orders-in 目的 地 是 为 与 order-service 服 
务 直 接 通信 而 创建 的 队列 ， 因 而 只 有 orders-out 按 服务 名 称 分 组 。 为 product-service 服务 
也 准备 了 类 似 的 配置 。 

SPpIring: 

cloud: 
stream: 
bindings: 
output: 
destination: orders-in 
input: 
destination: orders—out 
grIoup: account 


第 一 个 区 别 在 为 RabbitMQ 交换 信息 自动 创建 的 队列 名 称 中 可 见 。 现在 , 它 不 是 随机 
生成 的 名 称 , 如 orders-in.anonymous.qNxjzDq5Qra-yqHLUv50PQ，, 而 是 由 目标 和 分 组 名 称 
组 成 的 确定 字符 串 。 如 图 11.6 所 示 的 屏幕 截 图 显示 了 RabbitMQ 上 当前 存在 的 所 有 队列 。 


Name Features State Ready Unacked Total incoming deliver / get ack 
orders-in.anonymous.qNxjzDqS5Qra-yqHLUvS50PQ pp Ewad idle 2 2 2.6/5 0.20/s 0.00/s 


orders-out.account D running 


orders-out.product D idle 0.20/s 0.20/s 


11.6 在 RabbitMQ 上 当前 存在 的 所 有 队列 


开发 人 员 可 以 上 自己 执行 重新 测试 ， 以 验证 该 消息 是 否 仅 由 同一 组 中 的 一 个 应 用 程序 
接收 。 但 是 ， 开 有 友人 员 无 法 确定 哪个 实例 将 处 理 传 入 的 消息 。 为 了 确定 这 一 点 ， 可 以 考 


。236 。 精通 Spring Cloud 微服 务 架 构 


虑 使 用 分 区 机 制 。 
3. 分 区 机 制 


Spring Cloud Stream 文 持 在 多 个 应 用 程序 实例 之 间 对 数据 进行 分 区 (Patrtitioning〉。 
在 典型 的 用 例 中 ， 目 标 可 被 划分 为 不 同 的 分 区 。 每 个 生产 者 在 发 送 由 多 个 使 用 者 实例 接 
收 的 消 思 时， 将 确保 由 配置 的 字段 标识 数据 以 强制 由 同一 使 用 者 实例 处 理 。 

要 为 应 用 程序 启用 分 区 功能 ， 必 须 在 生产 者 配置 设置 中 定义 partitionKeyExpression 
或 partitionKeyExtractorClass 属性 以 及 partitionCount。 以 下 是 可 能 为 应 用 程序 提供 的 示例 
配 直 。 

Spring.cloud.stream.bindings.output.producer.partitionKeyExpresslon = 


payload.customerId 
spring.cloud.stream.bindings.output .producer.partitionCount = 2 


分 区 机 制 还 需要 在 使 用 者 端 设 置 spring.cloud.stream.instanceCount 和 spring.cloud. 
stream.instanceIndex 属性 。 还 必须 将 spring.cloud.stream.bindings.input.consumer.partitioned 
属性 设置 为 true 才能 显 式 启 用 它 。 实例 索引 负责 标识 特定 实例 从 中 接收 数据 的 唯一 分 区 。 
一 般 来 说 ， 生 产 者 端的 partitionCount 和 使 用 者 端的 instanceCount 应 该 相等 。 

现在 来 了 解 一 下 由 Spring Cloud Stream 提供 的 分 区 机 制 。 首 先 ， 它 将 根据 
partitionKeyExpression 计算 分 区 键 , 该 分 区 键 是 根据 出 站 消 明 或 PartitionKeyExtractorStrateegy 
接口 的 实现 来 计算 的 ,该 接口 定义 了 用 于 提取 消 四 的 键 的 算法 。 计 算 完 消息 的 键 之 后 ， 目 标 分 
区 将 被 确定 为 0 和 partitionCount-l 之 则 的 值 。 默 认 计算 公式 为 key.hashCodeO%partitionCount。 
它 可 以 使 用 partitionSelectorExpression 属性 进行 目 定 义 , 也 可 以 创建 org.sprineframework. 
cloud.stream.binder.PartitionSelectorStrategy 接口 的 实现 。 计 算出 的 键 将 与 使 用 者 端的 
instanceIndex | 此 配 。 

在 解释 了 围绕 分 区 机 制 的 主要 概念 之 后 ,现在 可 以 来 看 一 看 其 示例 。 以 下 是 product- 
service 服务 输入 通道 的 当前 配置 (与 为 account-service 服务 设置 的 账户 分 组 名 称 相 同 ) 。 

SpIring: 

cloud: 

stream: 

bindings: 
input: 
CONSUMEeLI: 
partitioned: true 

destination: orders—out 
group: product 
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现在 每 个 微服 务 都 有 两 个 正在 运行 的 实例 ， 它 们 使 用 来 日 主题 交换 信息 的 数据 。 在 
order-service 服务 中 还 为 生产 者 设置 了 两 个 分 区 。 消 息 键 是 根据 Order 对 象 中 的 customerId 
字段 计算 的 。 索 引 为 0 的 分 区 专用 于 customerId 字段 中 具有 偶数 的 订单 ， 而 索引 为 1 的 
分 区 则 用 于 customerId 字段 中 的 奇数 订单 。 

实际 上 ，RabbitMQ 没有 对 分 区 的 原生 支持 。 有 趣 的 是 ，Spring Cloud Stream 使 用 
RabbitMQ 实现 分 区 处 理 的 方式 。 在 如 图 11.7 所 示 的 屏幕 截图 中 ， 显 示 了 在 RabbitMQ 中 
创建 的 交换 信息 的 绑 定 列表 。 在 该 图 中 可 见 已 经 为 exchange-orders-out-0 和 orders-out-l 
定义 了 两 个 路 由 键 。 

Exchange: orders-out 
Message rates [ast minute 3 

Currentiy idle 

Details 


Type | topic 


Features durable: true 


Policy 


-= Bindings 


This exchange 


Routing key Arguments 


orders-out-0 


orders-0ut-1 


orders-0ut-0 


orders-0ut-1 


图 11.7 在 RabbitMQ 中 创建 的 交换 信息 的 绑 定 列表 


如 果 在 JSON 消息 中 发 送 了 一 个 customerId 等 于 1 的 订单 ， 如 f"customerId":1， 
"productIds":[4],"status":"NEW"}， 那 么 它 将 始终 由 instanceIndex = 1 的 实例 处 理 。 可 以 在 
应 用 程序 日 志 中 或 使 用 RabbitMQ Web 控制 台 来 查看 它 。 如 图 11.8 所 示 就 是 一 个 包含 每 
个 队列 的 消 晨 速率 的 屏 间 截 图 ， 可 以 看 到 customerId = 1 的 消息 已 被 多 次 发 送 。 
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站 WETViEWW Messages Message rates 


Name Faatures state Ready Unacked Total incoming deliver / get ack 


orders-in.anonymous.IoLFDyYEMTZCsMI2R7-ac9Q pp Exd running 导 生 | 45 8.8/s 0.40/s 0 .00/s 


orders-out.account-0 idle 
orders-out.account-—1 running 
orders-out.product-0 idle 


orders-out.product-1 1 running 


图 11.8 ”在 RabbitMQ Web 控制 台中 查看 被 处 理 的 消息 
11.4 配置 选项 


可 以 使 用 Spring Boot 文 持 的 任何 机 制 ( 如 应 用 程序 参数 、 环境 变量 和 YAML 或 属性 
文件 ) 履 盖 Spring Cloud Stream 配置 设置 。 它 定义 了 许多 可 应 用 于 所 有 绑 定 器 的 通用 配 
置 选项 。 但 是 ， 还 有 一 些 与 应 用 程序 使 用 的 特定 消息 代理 相关 的 其 他 属性 。 


11.4.1 Spring Cloud Stream 属性 


当前 的 属性 组 适用 于 整个 Spring Cloud Stream 应 用 程序 。 表 11.1 中 的 所 有 属性 都 以 


spring.cloud.stream 为 前 级 。 


表 11.1 Spring Cloud Stream 属性 


名 称 说 上 明 
应 用 程序 的 运行 实例 数 。 有 关 更 多 详细 信息 ， 请 参阅 第 
11.3.2 节 “ 扩 展 和 分 组 ” 


instanceCount 
i oo 应 用 程序 实例 的 索引 。 有 关 更 多 详细 信息 ， 请 参阅 第 
有 11.3.2 节 “ 扩 展 和 分 组 ” 

-| 可 以 动态 绑 定 的 目标 列表 

居 如 果 定 义 了 多 个 绑 定 器 ， 则 为 默认 绑 定 器 。 有 关 更 多 详 


细 信 息 ， 请 参阅 第 11.7 节 “ 多 个 绑 定 器 ” 


仅 在 云 处 于 活动 状态 且 在 类 路 径 中 找到 Spring Cloud 
i ee i Connectors 时 才 使 用 此 选项 。 当 它 设置 为 tue 时 ， 绑 定 
人 VEITTIOUELLOUCOLULOTDDOECLOLS dlSC 器 将 完 全 包 上 绑 定 的 服 务 并 依 赖 i 


spring.kafka.* Spring Boot 属性 


dvnamicDestinations 


defaultBinder 
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11.4.2 ” 绑 定 属性 


下 一 组 属性 与 消息 通道 相关 。 在 Spring Cloud 术语 中 ， 这 些 都 是 绑 定 属性 。 它 们 可 以 
仅 分 配给 使 用 者 、 生 产 者 或 同时 分 配给 两 者 。 表 11.2 是 绑 定 属性 列表 及 其 默认 值 和 说 明 。 


表 11.2 绑 定 属 性 列表 及 其 默认 值 和 说 明 


名 称 说 。 明 
a 为 消息 通道 配置 的 代理 上 的 目标 名 称 。 如 果 通 道 仅 由 一 个 使 用 者 使 用 ， 
则 可 以 将 其 指定 为 逗号 分 隔 的 目标 列表 
本 通道 的 使 用 者 分 组 。 有 关 更 多 详情 请 参阅 第 11.3.2 节 “ 扩 展 和 分 组 ” 
通过 给 定 通道 交换 的 消息 的 内 容 类 型 。 例 如 ， 可 以 将 它 设置 为 
contentType applicatiomjson。 然 后 ， 从 该 应 用 程序 发 送 的 所 有 对 象 将 自动 转换 为 
JSON 字符 串 
ne 通道 使 用 的 默认 绑 定 器 。 有 关 更 多 详情 请 参阅 第 11.7 节 “ 多 个 绑 定 器 ” 
1. 使 用 者 


以 下 属性 列表 仅 适 用 于 输入 绑 定 ， 并 且 必 须 以 spring.cloud.stream.bindings. 
<channelName>.consumer 为 前 级 。 其 中 最 重要 的 一 些 属性 如 表 11.3 所 示 。 


表 11.3 ”适用 于 使 用 者 的 重要 属性 
名 称 说 明 
concurrene' 1  ” ” | 每 个 输入 通道 的 使 用 者 数量 
i 它 人 允许 接收 来 自分 区 的 生产 者 的 数据 
headerMode embeddedHeaders | 如果 将 其 设置 为 rawW， 则 禁用 输入 上 的 标 头 解析 
Gt 在 消息 处 理 失 败 之 后 的 重 试 次 数 。 将 此 选项 设置 为 1 将 禁用 重 试 机 制 
2 生产 者 


以 下 绑 定 属性 仅 可 用 于 输出 绑 定 ， 并 且 必 须 以 spring.cloud.stream.bindings. 
<channelName>.producer 为 前 级 。 其 中 最 重要 的 一 些 如 表 11.4 所 示 。 


表 11.4 适用 于 生产 者 的 重要 属性 


名 称 说 了 明 
requiredGroups 中 | 必须 在 消 姑 代理 上 创建 的 以 逗号 分 隔 的 分 组 列表 
headerMode 如 果 将 其 设置 为 raw， 则 禁用 输入 上 的 标 头 解析 
useNativeEncodine 如 果 将 其 设置 为 tme， 则 出 站 消 姑 将 由 客户 问 库 直接 序列 化 


errorChannelEnabled 如 果 将 其 设置 为 tne， 则 将 失败 消息 发 送 到 目标 的 错误 通道 
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11.5 融 级 编程 模型 


Spring Cloud Stream 编程 模型 的 基础 知识 与 点 对 点 和 发 布 /订阅 通信 的 示例 将 一 起 介 
绍 。 现 在 来 讨论 一 些 更 高 级 的 示例 功能 。 


11.5.1 制作 消息 


在 本 章 介绍 的 所 有 示例 中 ， 我 们 已 通过 RESTful API 发 送 订 单 以 进行 测试 。 但 是 ， 
开发 人 员 也 可 以 通过 在 应 用 程序 内 定义 消息 源 来 轻松 创建 一 些 测 试 数据 。 以 下 是 一 个 使 
用 @Poller 的 bean， 它 将 每 秒 生 成 一 条 消 忠 ， 并 将 其 发 送 到 输出 通道 。 


QBean 
QInboundChannelAdapter (value = Source.OUTPUT, poller = QPpoller (fixedDelay = 
“1000"- maxMessagesPerPoll = "1")) 
public MessageSource<Order> ordersSourcel(}) 1 

Random r = new Random(); 

return () -> new GenericMessage<> (new Order (OrderSstatus.NEW, (long)} 
r.nextIint (5}, Collections.singletonList((long) r.nextInt (10)})))}); 
} 


11.5.2 ”转换 


如 前 文 所 述 ，account-service 服务 和 product-service 服务 已 经 从 order-service 服务 接 
收 事 件 ， 然 后 发 回 啊 应 消 恩 。 我 们 创建 了 OrderSender bean， 它 负责 准备 啊 应 有 效 负 载 并 
将 其 发 送 到 输出 通道 。 事 实证 明 ， 如 果 在 方法 中 返回 啊 应 对 象 并 使 用 @SentTo 注解 它 ， 
则 实现 可 能 会 更 简单 。 

astreamListener (Processor.INPUT) 

QSendTo (Processor .OUTPUT) 

Public Order receiveAndSendOrder (Order order) throws 

JsonProcessingException | 

LOGGER.infol("Order received: 1}", mapper .writeValueAsString (order})); 


return Service.process (order}:; 


} 


我 们 甚至 可 以 想象 诸如 以 下 形式 的 实现 , 而 不 使 用 @StreamListener。 转换 器 (Transformer) 
模式 将 负责 更 改 对 象 的 形式 。 在 这 种 情况 下 ， 它 会 修改 两 个 order 字段 一 一 status (状态 ) 
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和 price 〈 价 格 ) 。 


daEnableBinading(Processor -class) 
public class OrderProcessor 1 


Transformer (inputChannel = Processor.INPUT, outputChannel = 
Processor.OUTPUT) 
Public Order process (final Order order}) throws JsonProcessingExceptiont 
LOGGER. info("Order processed: {|}".,mapper.writeValueAsSstring (Order) ) ; 
ee . 
products .forEach(p -> order.setPprice (order.getPrice(}) + 
p.getPrice()}); 
if (order.getPrice() <= account .getBalance()}) 1{ 
order.setSstatus (Orderstatus .CCEPTED) ， 
account .setBalance (account .getBalance() - order.getPprice (}}; 
} else 1 
Order.setstatus (Orderstatus .REJECTED); 
} 


return order:; 


11.5.3 ”有 条 件 地 使 用 消息 


假设 开 友 人 员 硕 望 以 不 同方 式 处 理 传 入 同一 消息 通道 的 消 思 ， 则 可 以 使 用 条 件 分 派 。 
Spring Cloud Stream 文 持 根据 条 件 将 消息 分 派 给 在 输入 通道 上 注册 的 多 个 @StreamListener 
方法 。 该 条 件 是 在 @StreamListener 注解 的 condition 属性 中 定义 的 Spring 表达 式 语 言 
(Spring Expression Languapge，SpEL ) 表达 式 。 
public boolean sendi{Order order) 1{| 
Message<Order> orderMessage = 
MessageBuilder.withPayload (order) .build(}; 
orderMessage .getHeaders{}) .put(" PEOcesSor ， account ): 


return this.source.output() .Sena (OrdeTMesSssage) : 


} 

以 下 束 是 一 个 示例 实现 ， 它 定义 了 两 个 使 用 @StreamListener 注解 的 方法 ， 这 些 方法 
侦 听 同一 主题 。 其 中 一 个 专用 于 从 account-service 服务 传 入 的 消 恩 ， 而 第 三 个 则 专用 于 
product-service 服务 。 传 入 消 上 县 将 根据 带 有 processor 名 称 的 标 头 进行 分 派 。 
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QSpringBootApplication 
QEnableDiscoveryClient 
QEnableBinding (Processor.class) 
public class OrderApplication 1 


QSstreamListener (target = Processor.INPUT, condition = 
"headers|[ Processor | == account ") 
Public Vold recelveOrder (Order order) throws JsonProcessingException 1 
LOGGER.info("Order received from account: {}", 
mapper .writeValueAsString (order)}))}; 


i 
| 
daStrearmListeneTr (target = Processor .INPUT， condition = 
“DeadeTrs[l processor | == Proauct ") 


Public void recelveOrder (Order order) throws JsonProcessingException 1 
LOGGER.1info("Order received rom product: {1}., 
mapper.writeValueAsSstring (order))}; 
Nv 
} 


11.6 使 用 Apache Kafka 


在 讨论 Spring Cloud 与 消息 代理 的 集成 时 ， 我 们 曾经 多 次 提 到 过 Apache Kafka。 但 
是 , 到 目前 为 止 , 我 们 还 没有 基于 该 平台 运行 任何 示例 。 事实 上 , RabbitMQ 在 使 用 Spring 
Cloud 项 目 时 往往 是 首选 ， 但 是 Kafka 也 值得 我 们 关注 。 与 RabbitMQ 相 比 ， 它 的 一 个 优 
势 是 对 分 区 的 原生 支持 ， 而 分 区 正 是 Spring Cloud Stream 最 重要 的 功能 之 一 。 

Kafka 不 是 典型 的 消息 代理 。 它 是 一 个 分 布 式 流 媒 体 平 台 。 它 的 主要 功能 是 允许 开发 
人 员 发 布 和 订阅 记录 (Record) 流 。 它 对 转换 或 啊 应 数据 流 的 实时 流 应 用 程序 特别 有 用 。 
它 通 党 作为 由 一 个 或 多 个 服务 器 组 成 的 集群 运行 ， 并 可 以 在 主题 中 存储 记录 流 。 


11.6.1 运行 Kafka 


糟 粒 的 是 ，Apache Kafka 没有 正式 的 Docker 镜像 。 但 是 ， 我 们 可 以 使 用 一 个 非 官 方 
的 ， 如 Spotify 共享 的 镜像 。 与 其 他 可 用 的 Kafka docker 镜像 相 比 ， 这 个 镜像 可 以 在 同一 
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容器 中 运行 Zookeeper 和 Kafka。 以 下 是 启动 Kafka 并 在 端口 9092 上 公开 它 的 Docker 命 
令 。 在 端口 2181 上 也 可 以 使 用 Zookeeper。 


docker run -中 --name kafka -P 2181:2181 -p 9092:9092 --env 
ADVERTISED HOST=192.168.99.100 --enV ADVERIISED PORT=9092 spotify/kafka 


11.6.2 上 自 定义 应 用 程 友 设 置 


要 为 应 用 程序 局 用 Apache Kafka， 需 要 将 spring-cloud-starter-stream-kafka 启动 程序 
包含 在 依赖 项 中 。 我 们 当前 的 示例 非常 类 似 于 发 布 /订阅 的 示例 ， 因为 它 使 用 了 RabbitMQ 
发 布 /订阅 ， 以 及 在 第 11.3 节 “ 发 布 /订阅 模型 ”中 介绍 过 的 分 组 和 分 区 机 制 。 唯 一 的 区 别 
在 于 依赖 项 和 配置 设置 。 

Spring Cloud Stream 将 自动 检测 并 使 用 类 路 径 中 找到 的 绑 定 器 。 可 以 使 用 spring. 
kafka.* 属 性 覆 冀 连接 设置 。 在 这 种 情况 下 中 ， 只 需要 将 目 动 配置 的 人 afka 客户 端 地 址 更 
改 为 Docker 机 器 地 址 192.168.99.100。 对 Zookeeper 也 应 该 执行 相同 的 修改 ， 因 为 
Zookeeper 将 由 Kafka 客户 端 使 用 。 


SpI1ing: 
application: 
name: Order—Service 
kaf ka: 
bootstrap Servers: 192.168.99.100=:9092 
Cloud: 
stream: 
bindings: 
output: 
destination: Orders out 
producer: 
partitionKeyExpression: payload.customerId 
partitionCount: 2 
input: 
destination: orders—in 
kaf ka: 
binder: 
kNodes: 192.16B.99.100 


在 启动 发 现 、 网 关 和 所 有 必需 的 微服 务实 例 后 ， 即 可 执行 与 先前 示例 相同 的 测试 。 
如 果 一 切 配置 正确 ， 则 应 该 在 应 用 程序 启动 期 间 在 日 志 中 看 到 以 下 片段 。 其 测试 结果 与 
基于 RabbitMQ 的 示例 完全 相同 。 
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16:58:30.008 INEO |[,| Discovered coordinator 192.168.99.100:9092 

(id: 214/7483641 rack: null) for group account. 

le:508:30.038 INEO [;|] Successfully JjJoined group account with generation 1 
16:58:30.039 INEO [,|] Setting newly assigned partitions 

[orders-out-0, orders-out- 1| for group account 

le6:58:30.081 INEO [,|] partitions assligned: 

[orders-out-0, orders-out 1| 


11.6.3 Kafka Streams API 支持 


Spring Cloud Stream Kafka 可 以 提供 专 为 Kafka Streams 绑 定 设计 的 绑 定 器 ,使 用 此 绑 
定 器 之 后 ， 应 用 程序 即 可 利用 Kafka Streams API。 要 为 应 用 程序 启用 此 类 功能 ， 需 要 在 
项 目 中 包含 以 下 依赖 项 。 
<dependency> 
<gqroupId>org.springframework.cloud</grouplId> 


<artifactIid>spring-cloud-stream-binder-kstream</artifactId> 
</dependency> 


Kafka Streams API 可 以 提供 高 级 流 DSL。 可 以 通过 声明 (@StreamListener 方法 将 
KStream 接口 作为 参数 来 访问 它 。KStream 为 流 操 作 提供 了 一 些 有 用 的 方法 ， 这 些 方法 来 
目 其 他 流 API， 如 map、flatMap、join 或 flter。 还 有 一 些 与 Kafka Stream 相关 的 其 他 方 
法 ,如 to(...) (用 于 向 主题 发 送 流 ) 或 through(...) (与 to 相同 , 但 也 会 从 主题 创建 KStream 
的 新 实例 ) 。 


QSpringBootApplication 
QEnableBinding (KStreamProcessor.class) 
public class AccountApplication 1 


@streamListener ("input") 
&SendTo ("output™") 
public KStream<?, Order> process (KStream<?, Order> input) 1 


了 了 


public static void main(String[] args) 1{ 


SpringApplication.run(AccountApplication.class, args);}; 
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11.6.4 ”配置 属性 


在 讨论 示例 应 用 程序 的 实现 之 前 ,我 们 已 经 介绍 了 Kafka 的 一 些 Spring Cloud 配置 设 
置 . 表 11.5 包含 了 一 些 最 重要 的 属性 , 可 以 设置 这 些 属性 来 自 定 义 Apache Kafka 绑 定 器 。 
所 有 这 些 属性 都 以 spring.cloud.stream.kafka.binder 为 前 级 。 


表 11.5 Kafka 的 重要 配置 属性 


名 称 | 默认 值 说 明 
i 以 逗号 分 隔 的 代理 列表 ， 包 含 或 不 包含 端口 信息 
defaultBrokerPort 如 果 没 有 使 用 brokers 属性 定义 端口 ， 则 设置 默认 端口 
zkNodes 以 逗号 分 隔 的 ZooKeeper 节点 列表 ， 包 含 或 不 包含 端口 信息 
a 如 果 没 有 使 用 zkNodes 属性 定义 端口 ， 则 设置 默认 的 ZooKeeper 
defaultzZkPort 2181 训 口 
a Kafka 客户 端 属性 的 键 / 值 映射 。 它 适用 于 由 绑 定 器 创建 的 所 有 客 
configuration 
户 端 
jieailes ” .| 将 由 绑 定 器 转发 的 自 定义 标 头 列表 
autoCreateTopics 如 果 设 置 为 tue， 则 绑 定 器 会 自动 创建 新 主题 
autoAddPartitions 如 果 设 置 为 ttue， 则 绑 定 器 会 自动 创建 新 分 区 


11.7 多 个 绑 定 器 


在 Spring Cloud Stream 术语 中 ， 可 以 实现 以 提供 与 外 部 中 间 件 的 物理 目标 的 连接 的 
接口 称 为 绑 定 蓓 (Binder) 。 目 前 , 有 了 两 种 可 用 的 内 置 绑 定 堪 实现 一 一 Ka 人 ka 和 RabbitMQ。 
如 果 想 要 提供 目 定 义 绑 定 器 库 ， 那 么 关键 接口 就 是 Binder (这 个 关键 接口 其 实 束 是 作为 
将 输入 和 输出 连接 到 外 部 中 间 件 的 策略 的 抽象 ) ， 它 有 两 个 方法 一 一 bindConsumer 和 
bindProducer。 有 关 更 多 详细 信息 ， 请 参阅 Spring Cloud Stream 规范 。 

对 开发 人 员 来 说 ， 重 要 的 是 能 够 在 单个 应 用 程序 中 使 用 多 个 绑 定 器 。 我 们 甚至 可 以 
混合 使 用 不 同 的 实现 ， 如 RabbitMQ 和 Kafka。Spring Cloud Stream 依赖 于 Spring Boot 在 
绑 定 过 程 中 的 自动 配置 。 类 路 径 上 可 用 的 实现 将 目 动 使 用 。 如 果 想 要 同时 使 用 默认 的 绑 
定 右 ， 请 在 项 目 中 包含 以 下 依赖 项 。 

<dependency> 


<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring—-cloud-stream-binder—rabbit</artifactId> 
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</dependency> 
<dependency> 
<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring—-cloud-stream-binder—kafka</artifactId> 
</dependency> 


如 果 在 类 路 径 中 找到 了 多 个 绑 定 右 ， 则 应 用 程序 必须 检测 应 将 哪个 绑 定 器 用 于 特定 
通道 绑 定 。 我 们 可 以 使 用 spring.cloud.stream.defaultBinder 属性 全 局 配置 默认 绑 定 器 ， 或 
者 使 用 spring.cloud.stream.bindings.<channelName>.binder 属性 为 每 个 通道 单独 配置 默认 
绑 定 露 。 现 在 不 妨 回 到 之 前 的 示例 ， 在 那里 配置 多 个 绑 定 器 。 我 们 需要 为 account-service 
服务 和 order-service 服务 之 间 的 直接 通信 定义 RabbitMQ， 并 为 order-service 服务 和 其 他 
微服 务 之 间 的 发 布 /订阅 模型 定义 Kafka。 

以 下 是 与 publish subscribe 分 文 (https://github.conmypiomin/sample-spring-cloud- 
messaging/tree/publish subscribe) 中 的 account-service 相同 的 配置 ， 但 它 基 于 两 个 不 同 的 


SpIring: 
cloud: 
stream: 
bindings: 
output: 
destination: orders—in 
binder: rabbitl 
input: 
Consumer: 
partitioned: true 
destination: orders—out 
binder: kafkal 
grIoup: account 
rabbit: 
bindings: 
output: 
producer: 
exchangeType: direct 
routingKeyExpression: ""#"" 
binders: 
rabbitl: 
type: rabbit 
environment: 
Spring: 
rabbitmg: 
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host: 192.168.99:100 
kafkal: 
type: kafka 
environment: 
SpIring: 
kafka: 
bootstrap—servers: 192.1068.99.100:9092 


11.8 小 结 


与 所 有 其 他 Spring Cloud 项 目 相 比 ，Spring Cloud Stream 可 以 被 视 为 一 个 单独 的 类 别 。 
它 通常 与 其 他 项 目 相 关联 ， 并 且 目 前 由 Pivotal Spring Cloud Data Flow 强力 推广 。 这 是 用 
于 构建 数据 集成 和 实时 数据 处 理 管 道 的 工具 包 。 当 然 ， 这 也 是 一 个 巨大 的 主题 ， 不 是 单 
独 的 一 本 书 就 可 以 讨论 完 的 。 

更 重要 的 是 ，Spring Cloud Stream 文 持 异步 消 息 传 递 ， 并 且 可 以 使 用 Spring 注解 样 
式 轻松 实现 .我们 认为 ,对 于 部 分 开发 人 员 来 说 , 这 种 服务 间 通 信 方 式 并 不 像 RESTful API 
模型 那么 明显 。 因 此 ， 我 们 更 专注 于 展示 使 用 Spring Cloud Stream 进行 点 对 点 和 发 布 / 订 
阅 通 信 的 示例 。 我 们 还 详细 介绍 了 这 两 种 消 明 传递 方式 之 间 的 差异 。 

发 布 /订阅 模型 并 不 是 什么 新 鲜 事 物 ， 但 是 由 于 Spring Cloud Stream 的 存在 ， 它 可 以 
很 容易 地 包含 在 基于 微服 务 的 系统 中 。 本 章 还 介绍 了 了 一些 关键 概念 ， 如 使 用 者 分 组 或 分 
区 。 阅 读 完 本 章 之 后 ， 开 发 人 员 应 该 能 够 基于 消息 传递 模型 实现 微服 务 ， 并 将 它们 与 其 
他 Spring Cloud 库 集成 ， 以 便 提供 日 志 记 录 、 跟 踊 或 仅 将 它们 部 署 为 现 有 的 基于 REST 
的 微服 务 系 统 的 一 部 分 。 
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安全 性 是 与 基于 微服 务 的 架构 相关 的 最 常 讨论 的 问题 之 一 。 对 于 所 有 与 安全 相关 的 
话题 来 说 ， 始 终 绕 不 开 一 个 主要 问题 ， 那 就 是 网 络 。 对 于 微服 务 ， 通 常 网 络 上 的 通信 上 比 
一 体 化 应 用 程序 要 多 得 多 ， 所 以 应 该 重新 考虑 认证 和 授权 的 方法 。 传 统 系统 通 第 采用 构 
筑 边 界 的 形式 进行 保护 ， 然 后 允许 前 端 服务 完全 访问 后 端 组 件 。 迁 移 到 微服 务 则 迫使 开 
发 人 员 将 这 种 方法 改 为 委托 访问 管理 。 

Spring Framework 如 何 解决 基于 微服 务 架 构 的 安全 问题 ? 它 提 供 了 知 干 个 实现 有 关 
号 份 验证 和 授权 的 不 同 模式 的 项 目 。 第 一 个 项 目 是 Spring Security, 它 是 安全 的 基于 Spring 
的 Java 应 用 程序 的 事实 标准 。 它 由 一 些 子 模块 组 成 , 可 以 帮助 开 友 人 员 开 始 使 用 SAML、 
OAnuth2 或 Kerberos。 另 外 还 有 Spring Cloud Security 项 目 ,， 它 提供 了 和 若干 个 组 件 ， 人 允许 开 
发 人 员 将 基本 的 Spring Security 功能 与 微服 务 架 构 的 主要 元 率 集 成 在 一 起 , 如 网 关 、 负 载 
均衡 器 和 REST HTTP 客户 端 。 

本 章 将 介绍 保护 基于 微服 务 的 系统 的 所 有 主要 组 件 。 我 们 将 从 Eureka 的 服务 发 现 开 
然后 转 到 Spring Cloud Config Server 和 服务 间 通 信 ， 最 后 再 讨论 API 网 关 的 安全 性 。 
本 章 将 要 讨论 的 主题 包括 : 

口 ”为 单个 Spring Boot 应 用 程序 配置 安全 连接 。 

为 基于 微服 务 架 构 的 最 重要 元 素 忆 用 HTTPS 通信 。 

加 密 和 解密 存储 在 Config Server 上 的 配置 文件 中 的 属性 值 。 

使 用 OAnuth2 为 微服 务 进行 基于 内 存 的 简单 身份 验证 。 

使 用 JDBC 后 端 存 储 和 JWT 令 牌 进行 更 高 级 的 OAuth2 配置 。 

口 ”在 与 Feign 客户 问 的 服务 间 通 信 中 使 用 OAuth2 授权 。 

接 下 来 就 让 我 们 先 从 基础 开始 ， 演 示 如 何 创建 第 一 个 安全 微服 务 ， 并 且 通 过 HTTPS 
公开 其 API。 


始 


hh 


LDO 


12.1 为 Spring Boot 启用 HTTPS 


如 果 要 使 用 SSL 并 通过 HTTPS 提供 RESTful API， 则 需要 生成 证 书 。 实 现 这 一 目标 
的 最 快 方法 是 通过 自 签 名 证 书 (Self-Signed Certificate) ， 这 对 于 开发 模式 来 说 已 经 足够 了 。 
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Java 运行 时 环境 (Java Runtime Environment，JRE) 提供 了 一 个 简单 的 证 书 管 理工 具 一 一 
keytool。 它 位 于 JRE HOME\bin 目录 下 。 以 下 代码 中 的 命令 将 生成 自 签名 证 书 并 将 其 放 
入 PKCS12 KeyStore。 除 了 KeyStore 的 类 型 ， 开 发 人 员 还 必须 设置 其 有 效 性 、 别 名 和 文 
件 名 。 在 开始 生成 过 程 之 前 ，keytool 还 会 询问 密码 和 一 些 其 他 信息 ， 如 下 所 示 。 


keytool genkeypair -alias account— key —kevyalg RSA ~—keysize 2048 storetype 
PRCS12 ~keystore account— key-pl2 validity 3650 


Enter keystore password: 

Re—enter new password: 

What is your first and last name? 
[Unknown|: localhost 

What is the name of your organizational unit? 
[Unknown|: = 

What is the name of your organization? 
[Unknown| : piomin 

What 1is the name of your City or Locality? 
[Unknown|: Warsaw 

What is the name of your State or Province? 
[Unknown|: mazowijeckie 

What is the two—letter country code for this unit? 
[Unknown|: PL 

Is CN=localhost, OU=Unknown, O=pliomin, L=WarsawW, ST=mazowijeckie, C=PL 

COIrTects 
[nol]: yes 


我 们 已 将 生成 的 证 书 复制 到 Spring Boot 应 用 程序 内 的 src/main/resources 目录 中 。 构 
建 并 运行 应 用 程序 后 ， 它 将 在 类 路 径 中 可 用 。 要 启用 SSL， 必 须 在 application.yml 文件 中 
提供 一 些 配置 设置 。 通 过 设置 各 种 server.ssl.* 属 性 ， 可 以 为 Spring 自 定 义 SSL。 


Server: 
port: S${PORT:8090} 


sal: 

key—store: classpath:account— key.pl2 
key—store~—password: 123456 
key—store-—type: PRECS12 

key—-alias: account— key 


security: 
TeEgulre ss Frie 
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12.2 ”保证 发 现 服务 器 的 安全 


如 前 文 所 述 ， 微 服务 应 用 程序 的 SSL 配置 并 不 是 一 项 非常 艰巨 的 任务 。 但 是 ， 是 时 
候 提 高 其 难度 等 级 了 。 我 们 已 经 启动 一 个 通过 HTTPS 提供 RESTful API 的 单一 微服 务 。 
现在 希望 微服 务 与 发 现 服务 器 集成 。 由 此 产生 了 两 个 问题 。 第 一 个 是 需要 在 Eureka 上 发 
布 有 关 安 全 微服 务实 例 的 信息 ;第 二 个 问题 涉及 通过 HTTPS 欢 圳 Eureka 并 强制 发 现 客 
户 端 使 用 私 钥 对 发 现 服务 器 进行 身份 验证 。 接 下 来 我 们 将 详细 讨论 这 些 问题 。 


12.2.1 注册 安全 的 应 用 程序 


如 果 应 用 程序 通过 安全 的 SSL 端 口 人 公开 ， 则 应 将 EurekalInstanceConfig- 
nonSecurePortEnabled 中 的 两 个 标志 更 改 为 false， 将 securePortEnabled 更 改 为 true。 这 迫 
使 Eureka 发 布 实例 信息 , 显示 对 安全 通信 的 明确 偏好 。 对 于 以 这 种 方式 配置 的 服务 ,Spring 
Cloud DiscoveryClient 将 始终 返回 以 HTTPS 开头 的 URL, 并 且 Eureka 实例 信息 将 具有 安 
全 的 运行 状况 检查 URL。 

euUreka: 

jnstance: 

nonsSsecurePortEnabled: false 

securePortEnabled: true 

securePort: S${PORT:8091} 

statusPageUrl: https://localhost:s{eureka.instance.securePort}/info 


healthCheckUrl: https://localhost:${eureka.instance.securePort}/health 
homePageUrl: https://localhost:${eureka.instance.securePort)} 


12.2.2 ”通过 HTTPS 服务 Eureka 


当 Eureka 服务 器 以 Spring Boot 启动 时 , 它 将 部 署 在 租 入 式 Tomcat 容器 上 , 因而 SSL 
配置 与 标准 微服 务 相 同 。 不 同 之 处 在 于 我 们 必须 考虑 客户 端 应 用 程序 ， 该 应 用 程序 将 通 
过 HTTPS 与 发 现 服 务 右 建立 安全 连接 。 发 现 客户 问 应 该 针对 Eureka 服务 右 进 行 映 份 验 
证 ， 并 且 还 应 验证 服务 器 的 证 书 。 客 户 端 和 服务 器 之 间 的 通信 过 程 称 为 双 辐 安全套 接 层 
(Two-way SSL) 或 相互 身份 验证 (Mutual Authentication) 。 还 有 单 回 身份 验证 ， 这 实 
际 上 是 默认 选项 ， 它 只 有 客户 背 验 证 服务 器 的 公 钥 (Public Key) 。Java 应 用 程序 使 用 
KeyStore 和 trustStore 存储 与 公 钥 对 应 的 私 钥 (Private Key) 和 证 书 (Certificate) 。trustStore 
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和 KeyStore 之 间 的 唯一 区 别 是 它们 存储 的 内 容 和 有 用途。 执行 客户 端 和 服务 露 之 间 的 SSL 
握手 时 ， 将 使 用 trustStore 验证 凭据 ， 而 使 用 KeyStore 提供 凭据 。 换 句 话说 ，KeyStore 
为 给 定 的 应 用 程序 保留 私 钥 和 证 书 ， 而 trustStore 保留 用 于 从 第 三 方 识 别 它 的 证 书 。 在 配 
置 安全 连接 时 ， 开 发 人 员 通 常 不 会 过 多 关注 这 些 术 语 ， 但 正确 理解 它们 可 以 帮助 开发 人 
员 轻 松 了 解 接 下 来 会 发 生 什 么 。 

在 典型 的 基于 微服 务 的 架构 中 ， 有 许多 独立 的 应 用 程序 和 单个 发 现 服务 上 器。 一 方面 ， 
每 个 应 用 程序 都 有 自己 的 私 钥 存储 在 KeyStore 中 , 并 且 证 书 对 应 于 trustStore 中 的 发 现 服 
务 器 的 公 和 钥 。 男 一 方面 ， 服 务 器 保留 为 客户 端 应 用 程序 生成 的 所 有 证 书 。 这 就 是 现在 的 
理论 。 如 图 12.1 所 示 ， 它 说 明了 在 前 面 的 章节 中 作为 示例 使 用 的 系统 的 情况 。 


accounNnt.cer 
CUStOMEr.cefr 
order.cer 


BProeduct.cer 


account.jks 


Account 
瑟 二 FVi 旋 


图 12.1 示例 系统 的 安全 架构 

1. Keystore 的 生成 

在 讨论 了 Java 中 的 安全 性 基础 知识 之 后 , 即 可 继续 为 我 们 的 微服 务 生 成 私 钥 和 公 钥 。 
和 以 前 一 样 ， 我 们 将 使 用 JRE re 命令 行 工 具 keytool。 让 我 们 从 一 个 众所周知 的 用 
于 生成 市 密 钥 对 的 keystore 文件 命令 开始 ， 首 先 为 发 现 服务 器 生 成 一 个 KeyStore， 然 后 
为 一 个 选 定 的 微服 务 (在 这 个 特定 示例 y 我 们 选 定 的 是 account-service 服务 ) 生成 第 二 
个 KeyStore。 

keytool -genkey -allas account -store type JEKS -keyalg RSA -keysize 2048 -一 

keystore account.Jks -validity 3650 


keytool -genkey -alias discovery -storetype JKS -keyalg RSA -keysize 2048 -一 
keystore discovery.Jks -validity 3650 
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然后 ， 必 须 将 上 自 签 名 证 书 从 KeyStore 导出 到 文件 ， 例 如 ， 扩 展 名 为 .cer 或 .crt 的 
文件 。 然 后 ， 系 统 将 提示 输入 KeyStore 生成 期 间 提供 的 密码 。 
keytool -exportcert -alias account -keystore account . ]Kks -file accCount .Ce 


Keytool -exportcert -alias discovery -Kkeystore discovery.Jks -file 
discovery .cer 


鉴于 已 经 从 KeyStore 中 提取 了 与 公 钥 对 应 的 证 书 ， 因 而 现在 可 以 将 其 分 发 给 所 有 感 
兴趣 的 各 方 。 来 目 account-service 服务 的 公共 证 书 应 包含 在 发 现 服务 右 的 trustStore 中 ， 
反之 亦 然 。 

Kkeytool -importcert -alias discovery -keystore account.Jks -file 

discovery .cer 


Keytool -importcert -alias account -keystore discovery.Jks -file 
account .cer 


必须 为 在 Eureka 服务 咒 中 注册 目 身 的 每 个 后 续 微 服务 重复 执行 与 account-service 服 
务 相 同 的 步骤 。 以 下 是 用 于 为 order-service 服务 生成 SSL 密 钥 和 证 书 的 keytool 命令 。 


keytool -genkey -alias order -storetype JKS -keyalg RSA -keyslze 2048 - 
Keystore order.Jks -validity 3650 

keytool -exportcert -alias order -keystore order.Jks -file order.cer 
keytool -importcert -alias discovery -keystore order.Jks -file 
discovery .cer 

keytool -importcert -alias order -keystore discovery.Jks -file 

order .cer 


2. 配置 微服 务 和 Eureka 服务 器 的 SSL 
每 个 keystore 文件 都 放 在 每 个 安全 微服 务 和 服务 发 现 的 src/main/resources 目录 中 。 
每 个 微服 务 的 SSL 配置 设置 与 第 12.1 节 “ 为 Spring Boot 启用 HTTPS” 中 的 示例 非常 
似 。 唯 一 的 区 别 是 当前 使 用 的 KeyStore 的 类 型 ， 现 在 是 的 S 而 不 是 PRCS12。 但 是 , 之 
前 的 示例 和 服务 发 现 配 置 之 间 存在 更 多 差异 。 首 先 ， 我 们 已 经 通过 将 server.ssl.client-auth 
属性 设置 为 need 来 月 用 客户 端 证 书 身 份 验证 , 这 反 过 来 要 求 我 们 提供 带 有 server.ssl.trust- 
store 属性 的 trustStore。 以 下 是 application.yml 文件 中 发 现 服务 的 当前 SSL 配置 设置 。 
Server: 
port: S${PORT:8761)] 
S32 
enabled: true 
client-auth: need 
key—store: classpath:discovery.]ks 
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kev—store—pPassword: 123456 

trast store: Classpalth discovery. ks 
trust-store—password: 123456 
key—-alias: discovery 


如 果 开 发 人 员 使 用 上 述 配置 运行 Eureka 应 用 程序 ， 人 然后 尝试 访问 https://localhost:8761/ 
下 可 用 的 Web 仪表 板 , 则 可 能 会 收 到 类 似 SSL_ ERROR BAD CERT _ ALERT 的 错误 代码 。 
发 生 此 错误 的 原因 是 没有 可 信 证 书 导入 Web 浏览 器 。 为 此 ， 我 们 可 以 从 服务 〈 如 
account-service 服务 ) 中 导入 客户 端的 应 用 程序 KeyStore。 但 首先 ， 我 们 需要 将 其 从 形 S 
格式 转换 为 Web 浏览 器 支持 的 另 一 种 格式 ， 如 PKCS12。 以 下 是 用 于 将 KeyStore 从 JKS 
转换 为 PKCS12 格式 的 keytool 命令 。 


keytool -importkeystore -srckeystore account.Jks -srcstoretype JKS - 
deststoretype PKCS12 -destkeystore account.pl2 


所 有 最 流行 的 网 络 浏 览 器 都 支持 PKCS12， 如 Google Chrome 和 Mozilla Firefox。 要 
将 PKCS12 age 导入 Google Chrome 浏览 器 ， 开 发 人员 可 以 单 击 “ 设 置 ” 命 令 ， 然 
后 显示 “高 级 ”设置 部 分 ， 找 到 “管理 证 书 ” 管理 HTTPS / SSL 证 书 和 设置 ) ， 单 击 
打开 “证 书 ” 对 话 框 。 如 果 再 次 尝试 访问 Eureka Web 仪表 板 ， 则 应 成 功 进 行 身 份 验 证 ， 并 
日 将 能 够 看 到 已 注册 服务 的 列表 。 但 是 ， 在 这 里 并 没有 已 注册 的 应 用 。 为 了 在 发 现 客户 端 
和 服务 器 之 让 ] 提 供 安 全 通信 ,我们 需要 为 每 个 微服 务 创建 一 个 DiscoveryClientOptionalArgs 
类 型 的 @Bean， 它 会 覆盖 发 现 客 户 端的 实现 。 有 趣 的 是 ，Eureka 使 用 Jersey 作为 REST 
客户 疹 。 使 用 EurekajJerseyClientBuilder， 开 发 人 员 可 以 轻松 构建 新 的 客户 站 实现 并 传递 
keystore 和 truststore 文件 的 位 置 。 以 下 是 来 自 account-service 的 代码 片段 ,我们 在 其 中 创 
建 了 一 个 新 的 EurekaJerseyClient 对 象 并 将 其 设置 为 DiscoveryClientOptionalArgs 的 参数 。 


Bean 
Public DiscoveryClient .DiscoveryClientOptionalArgs 
discoveryClientOoOptionalArgs() throws NoSuchAlgorithmException 1 
DjscoveryClient .DiscoveryClientoptionalArgs args = Dew 
DiscoveryClient.DiscoveryClientOoOptionalArgs (); 
System.setPropertyl(" Javax.net.ssl.keyStore", 
"src/main/resources/account .Jks"); 
System.setProperty( Javax.net.ssl.keyStorePassword”, 1234500"): 
system.setPropertyl( Javax.net.ssl.trustSstore”™, 
"src/main/resources/account .Jks"); 
Svestem:sSetPropertyl( Javax.net. Ssl:trustStorePassword , “12345006")} 
EurekaJerseyClientBRuilder builder = new EurekaJersevyClientBuilder (); 
builder.withClientName ("account—client™); 
builder.withSystemSSsLConfiguration(}; 
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builder.withMaxTotalConnections (10}); 
builder.withMaxConnectionsPerHost (10);} 
args.sSetEurekaJerseyClient (builder.build(})}; 
return args; 


} 


在 我 们 的 示例 系统 中 ， 应 该 为 每 个 微服 务 提供 类 似 的 实现 。GitHub (https://github.cony 
piomin/sample-spring-cloud-security.git) 上 提供 了 示例 应 用 程序 的 源 代码 。 开 友人 员 可 以 
克隆 它 并 使 用 和 集成 开发 环境 运行 所 有 Spring Boot 应 用 程序 。 如 果 一 切 正 常 ， 则 应 该 在 
Eureka 仪表 板 中 看 到 相同 的 注册 服务 列表 ， 如 图 12.2 所 示 。 如 果 SSL 连接 有 任何 问题 ， 
则 可 以 答 试 在 应 用 程序 局 动 期 间 设置 -Djava.net.debug=ssl VM 参数 ， 以 便 能 够 从 SSL 握 
手 过 程 中 检查 出 完整 日 志 。 


Instances currently registered with Eureka 


Application AMMls Avallability Zones Status 
ACCOUNT-SERVICE n/a ll1) 11) UP (1)- minkewe-l.pd.crg:account-service:8091 
CUSTOMER-SERVICE nia (ll] 11] UP {1} =- minkowp-l.sd.corg:customer-service:Bod92 


ORDER-SERVICE n/a (1) (1) UP (1) - minkowp-l.p4.org:order-service:8090 


PRODUCT-SERVICE n/a (1) (1) UP (1} - minkowp 


12.2 在 Eureka 仪表 板 中 看 到 的 注册 服务 列表 
12.3 ”保证 配置 服务 器 的 安全 


在 讨论 安全 性 时 ， 我 们 的 架构 中 还 有 另外 一 个 关键 元 素 一 一 Spring Cloud Config 
Server。 事 实 上 ,保护 配置 服务 器 比 保 护 发 现 服务 更 重要 。 为 什么 ? 因为 我 们 通常 会 将 它 
们 的 身份 验证 凭据 存储 到 外 部 系统 ， 甚 至 还 有 其 他 应 该 隐藏 的 数据 ， 以 防止 未 经 授权 的 
访问 和 使 用 。 有 知 干 种 方法 可 以 正确 保护 配置 服务 器 。 开 发 人 员 可 以 配置 HITP 基本 喘 
份 验证 、 安全 SSL 连接 、 加密/ 解密 敏感 数据 , 或 使 用 本 书 第 $ 章 “ 使 用 Spring Cloud Config 

进行 分 布 式 配置 ”中 所 述 的 第 三 方 工 具 。 现 在 来 仔细 看 看 其 中 的 一 些 。 


12.3.1 ”加密 和 解密 


在 开始 之 前 , 我 们 必须 下 载 并 安装 Oracle 提供 的 Java Cryptography Extension (JCE ) 。 
它 由 两 个 JAR 文件 (local policy.jar 和 US_export policy.jar) 组 成 ， 它 们 需要 履 亲 JRE 
lib/security 目录 中 的 现 有 策略 文件 。 
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如 果 存 储 在 配置 服务 器 上 的 远程 属性 源 包含 加 密 数 据 ， 则 它们 的 值 应 以 {cipher} 为 前 
级 并 用 引号 括 起 来 将 其 指定 为 YAML 文件 。.properties 文件 不 需要 包含 引号 。 如 果 无 法 
解密 这 样 的 值 ， 则 在 前 级 为 invalid 的 相同 键 下 将 其 奉 换 为 附加 值 (通常 为 <n /a>) 。 

在 上 一 个 示例 中 ， 我 们 存储 了 用 于 保护 应 用 程序 配置 设置 中 的 keystore 文件 的 密码 。 
将 其 保存 为 纯 文 本 文件 可 能 不 是 最 好 的 主意 ， 因 而 它 是 加 密 的 第 一 个 候选 者 。 问 题 是 ， 
我 们 应 该 如 何 加 密 它 ? 

洱 运 的 是 ，Spring Boot 提供 了 两 个 可 以 对 此 提供 帮助 的 RESTful 羔 点 。 

让 我 们 来 看 一 看 它 是 如 何 工 作 的 。 首 先 ， 我 们 再 要 局 动 一 个 配置 服务 器 实例 。 要 完 
成 该 目标 ， 最 简单 的 方法 是 激活 --spring.profiles.active=native 配置 文件 ， 该 配置 文件 使 用 
本 地 类 路 径 或 文件 系统 中 的 属性 源 局 动 服务 嚣 。 现 在 我 们 可 以 调用 两 个 POST 端点 
/encrypt 和 /decrypt。/encrypt 方法 将 我 们 的 纯 文 本 密码 作为 参数 。 可 以 使 用 反 回 操作 
/decrypt 检查 出 结果 ，/decrypt 操作 会 将 加 密 的 密码 作为 参数 。 

$ curl http://localhost:8888/encrypt -d 123456 

AQAZI8JV26K3n6ff+iFzQA9DUpWmg /9emWuAndEXyv]YNKFSGTrBmJPOoOFTDP8RzZJ]Z2bTwt4d 

ehRiKWaquSgqXkH8SAvV/8mr2kdwB28kfVvPj]/Lb5hdUkH1TVrylcnpZaKaQYBaxlsaO0RWAKOQ 

DK8MOKRW1INJSHMALY9yJjdaOYQFNYAYO /KRNWUFihiVS5xDkSIMOiGAbT77AVLMmMz+9asSAODKL 

O57TWwOQUzM1ItSA7Tl1IOS9HyDOW2Hz1]1q93uO0CaP5VOLCJAJmHcCcHvhlvMAA42bU3B29JNJH+2nFES 


ORhEyUvpUqzo+PBiAROAKJH9XZ8G7RaTOeWIcJhentKRfOU/EgWIVW21NpsE29BHwf4F2J 
Z1WY2+WqcHUuHK367X21vK11AV] 9tJk9aUVNRK= 


这 里 的 加 密 是 使 用 公 钥 完成 的 ， 而 解密 是 使 用 私 钥 完成 的 。 因 此 ， 如 果 仅 执行 加 密 ， 
则 只 需要 在 服务 器 中 提供 公 钥 。 出 于 测试 目的 ， 可 以 使 用 keytool 创建 KeyStore。 我 们 之 
前 已 经 创建 了 一 些 KeyStore， 因 而 不 会 遇 到 任何 问题 。 生 成 的 文件 应 放 在 类 路 径 中 ， 然 
后 使 用 encrypt.keyStore.* 属 性 置 于 config-service 配置 设置 中 。 


encrypt: 
keySstore: 
location: classpath:/config.jks 
password: 123456 
alias: config 
Secret: 123456 


现在 ， 如 果 将 每 个 微服 务 的 配置 设置 移动 到 配置 服务 器 ， 则 可 以 加 密 每 个 密码 ， 如 
以 下 示例 片段 所 示 。 
站 


SS : 
enabled: true 
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key—store: classpath:account.Jks 

key—store—password: 

{cipher}AQAzZI8 V26K3n6ff+1FZOQA9DUpPWmG /SemWuAndEXyv YNKESG /IrBmJPOOFTD 
8RzjZbTwt4ehRiKWquSqXKH8SAV/8mr2kdwB28kfVvP]/Lb5hdUkHI1TVrylcnpzZaKaQYBa 
XlSa0RWAKODKEKS8SMOKRWI1INJSHMALY 9yjda0YQFNYAYO /KRNWUFihiVSxDKEKS1IMOiGAPT TAVLm 
z+9aSADDKLOD IwOQUZzZMITtSAT1IO9HyYDOW2HzZ119q993u0CaP5VOLCJA]JmHCcHvh lvM442bU3B2 
9JNJH+2NnFSORhEyUvpPUgzZzo+PBiAROAKJH9XZ8G/RaTOeWIcJhentKRfOU/EgWIVW21NpsE 
29BHwt4E2UJ21WY2+WGCHuUHK36 /X21VEK11AV19tJk9aUVNRk=" 

key—allias: account 


12.3.2 配置 各 户 凯 和 服务 器 的 身份 验 十 


Spring Cloud Config Server 的 身份 验证 实现 与 Eureka 服务 器 完全 相同 ,开发 人 员 可 以 
使 用 基于 标准 Spring 安全 机 制 的 HTTP 基本 身份 验证 。 首 先 ， 需 要 确保 Spring-security 工 
件 位 于 类 路 径 中 ; 然后 ， 应 该 将 security.basic.enabled 设置 为 true 以 启用 安全 性 ， 并 定义 
用 户 名 和 密码 。 其 示例 配置 设置 如 以 下 代码 户 段 所 示 。 


Security: 
basic: 
enabled: true 
USEr: 
name: admin 
password: adminl123 


还 必须 在 客户 站 司 用 基本 号 份 验证 。 它 可 以 通过 两 种 不 同 的 方式 实现 。 第 一 种 方式 
是 通过 配置 服务 右 URL。 


SpIring: 
cloud: 
conf1ig: 
uri: http://admin:adminl23Q@localhost:8888 


第 二 种 方法 基于 单独 的 username 和 password 属性 。 


spring: 

cloud: 
config: 
uri: http://localhost:8888 
username: admin 


password: adminl23 


如 果 要 设置 SSL 身份 验证 ， 则 需要 按照 第 12.2 节 “ 保 证 发 现 服务 器 的 安全 ”中 所 描 
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述 的 步骤 进行 操作 。 使 用 私 钵 和 证 书生 成 KeyStore 并 设置 正确 的 配置 后 ， 开 发 人 员 可 以 
运行 配置 服务 器 。 现 在 ， 它 将 通过 HITPS 公开 其 RESTful API。 唯 一 的 区 别 在 于 客户 端 
的 实现 。 这 是 因为 Spring Cloud Config 使 用 的 是 与 Spring Cloud Netflix Eureka 不 同 的 
HTTP 客户 端 。 正 如 你 可 能 猜 到 的 那样 ， 它 利用 了 RestTemplate， 因 为 它 完全 是 在 Spring 
Cloud 项 目 中 创建 的 。 

要 强制 客户 端 应 用 程序 使 用 双 同 SSL 刁 份 验证 而 不 是 标准 的 非 安 全 HTTP 连接 ， 首 
先 应 该 创建 一 个 实现 PropertySourceLocator 接口 的 @Configuration bean。 在 这 里 ， 我 们 可 
以 构建 一 个 使 用 安全 HITP 连接 工厂 的 目 定 义 RestTemplate。 


QConfiguration 


public class SSLConfigServiceBootstrapConfiguration |{ 


RAutowireqd 


ConfigClientProperties PIopertiess 


Bean 
public ConfigServicePropertySourceLocator 
configServicePropertySourceLocator(} throws Exceptjon 1 
final char[|] password = "123456" .toCharArray()}); 
final File keyStoreFile = new 
File("src/main/resources/discovery.jks"); 

SSLContext sslContext = SSLContexts .custom!() 
.loadKeyMaterial (keyStoreFile, password, password) 
.loadTrustMaterial (keySstoreFile) .build()}); 

CloseableHttpClient httpClient = 

HttpClients.custom() .setSsLContext (sslContext) .build(}; 

HttpComponentsClientHttpRequestFactory regquestFactory = new 

HttpComponentsClientHttpRequestFactory (httpClient).; 
ConfigServicePropertySourceLocator 
configServicePropertySourceLocator = new 
ConfigServicePropertySourceLocator (properties),; 
configqServicePropertySourceLocator.setRestTemplate (new 
RestTemplate (requestFactory))});? 
return configqServicePropertySourceLocator; 


} 
但 是 , 默认 情况 下 ,在 应 用 程序 尝试 与 配置 服务 器 建立 连接 之 前 , 不 会 创建 此 Bean。 
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要 更 改 此 行为 ， 开 发 人 员 还 应 在 /src/main/resources/META-INF 中 创建 spring.factories 文 
件 ， 并 指定 自 定 义 引 导 程 序 配置 类 。 
org.springftramework.cloud.bootstrap.BootstrapConfiguration = 
pl .piomin.services.account.SSLConfigServiceBootstrapConftigquration 


12.4 ”使 用 OAuth2 进行 授权 


我 们 已 经 在 微服 务 环 境 中 讨论 了 与 里 份 验证 相关 的 一 些 概 念 和 解决 方案 。 前 文 已 经 
演示 了 微服 务 和 服务 发 现 之 间 ， 以 及 微服 务 和 配置 服务 器 之 间 的 基本 和 SSL 喘 份 验证 的 
示例 。 在 服务 间 通 信 中 ， 授 权 似 乎 比 身 份 验证 更 重要 ， 而 身份 验证 则 在 系统 的 边缘 实现 。 
开发 人 员 有 必要 了 解 身 份 验 证 和 授权 之 间 的 区 别 。 简 而 言 之 ， 喘 份 验 证 可 以 验证 访问 者 
的 身份 ， 而 授权 则 验证 访问 者 有 权 执 行 的 操作 。 

目前 ，RESTful HTTP API 最 流行 的 授权 方法 是 OAuth2 和 Java Web 令 脾 (Java Web 
Tokens，JWT) 。 它们 可 以 混合 在 一 起 ， 因 为 它们 比 其 他 解决 方案 更 加 互补 。Spring 可 以 
为 OAuth 提供 商 和 使 用 者 提供 支持 。 使 用 Spring Boot 和 Spring Security OAuth2， 开 发 人 
员 可 以 快速 实现 锅 见 的 安全 模式 ， 如 单 点 登录 、 令 牌 中 继 或 令 牌 交换 。 但 在 深入 了 解 有 
关 这 些 项 目的 细节 以 及 其 他 开发 细节 之 前 , 开发 人 员 需 要 掌握 上 述 解 决 方案 的 基本 知识 。 


12.4.1 OAuth2 简介 


OAnuth2 是 几乎 所 有 主要 网 站 目前 使 用 的 标准 ， 允 许 通 过 共享 API 访问 其 资源 。 它 将 
用 户 号 份 验证 委派 给 存储 用 户 凭 据 的 独立 服务 ， 并 授权 第 三 方 应 用 程序 访问 有 关 用 户 账 
户 的 共享 信息 。 OAuth2 用 于 为 用 户 提 供 数 据 访问 权限 , 同时 保护 其 账户 凭据 。 它 为 Web、 
更 面 和 移动 应 用 程序 提供 流程 。 以 下 是 与 OAuth2 相关 的 一 些 基 本 术语 和 角色 。 
口 ”资源 所 有 者 (Resource Owner) : 此 角色 将 控制 对 资源 的 访问 。 此 访问 权限 受到 
授权 范围 的 限制 。 
口 授予 权限 (Authorization Grant) : 授予 访问 权限 。 可 以 通过 多 种 方式 确认 访问 ， 
如 授权 代码 、 隐 式 、 资 源 所 有 者 密 但 凭据 和 客户 端 凭据 等 。 
口 ”资源 服务 器 (Resource Server) : 这 是 一 个 服务 器 ， 用 于 存储 可 以 使 用 特殊 令 牌 
共享 的 所 有 者 资源 。 
口 ”授权 服务 器 (Authorization Server) : 它 管理 密 钥 、 令 牌 和 其 他 临时 资源 访问 代 
码 的 分 配 。 它 还 必须 确保 授予 相关 用 户 访 问 权 限 。 
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口 访问 令 脾 (Access Token) : 这 是 允许 访问 资源 的 密 钥 。 
为 了 更 好 地 理解 这 些 术 语 和 角色 在 实践 中 的 作用 ， 请 查看 图 12.3。 它 可 视 化 了 使 用 
OAnuth 协议 的 授权 过 程 的 典型 流程 。 


客户 端 应 用 程序 “| 。 访问 令 牌 


访问 令 牌 | 
受 保护 的 资源 资源 服务 器 
大 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


图 12.3 使 用 OAnuth 协议 的 授权 过 程 的 典型 流程 


现在 我 们 来 看 一 看 之 前 列 出 的 各 个 组 件 之 间 交 互 的 进一步 步 又 。 应 用 程序 请 求 资源 
所 有 者 授权 ， 以 便 能 够 访问 所 请 求 的 服务 。 资 源 发 送 授权 作为 啊 应 ， 然 后 由 应 用 程序 将 
其 与 其 自 吴 的 里 份 一 起 发 送 全 授权 服务 占 。 授 权 服 务 占 将 验证 应 用 程序 标识 的 凭据 和 授 
予 的 权限 ， 然 后 再 发 送 访问 令 牌 。 应 用 程序 使 用 接收 的 访问 令 牌 从 资源 服务 器 请 求 资源 。 
最 后 ， 如 采访 问 令 牌 有 效 ， 则 应 用 程序 能 够 调用 请 求 服务 。 


12.4.2 构建 授权 服务 器 


从 单一 应 用 程序 迁移 到 微服 务 之 后 ， 显 而 易 见 的 解决 方案 似乎 是 通过 创建 授权 服务 
来 集中 授权 工作 。 使 用 Spring Boot 和 Spring Security， 开 发 人 员 可 以 轻松 创建 、 配 置 和 
启动 授权 服务 器 。 首 先 ， 需 要 在 项 目 依 赖 项 中 包含 以 下 启动 器 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-oauth2</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.cloud</groupId> 
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<artifactId>spring-cloud-starter-security</artifactId> 
</dependency> 

使 用 Spring Boot 实现 授权 服务 器 模式 非常 简单 , 只 需要 使 用 @EnableAuthorizationServer 
注解 主 类 或 配置 类 ， 然 后 在 application.yml 文件 中 提供 security.oauth2.client.client-id 和 
sectrity.oauth2.client.client-secret 属性 。 当 然 ， 这 种 变 体 应 尽 可 能 简单 ， 因 为 它 定 义 了 客 
户 瘦 详细 信息 服务 的 内 存 实现 。 

本 示例 应 用 程序 与 本 章 前 面 的 示例 位 于 同一 个 存储 库 (https://github.com/piomin/ 
sample-spring-cloud-security.git) 中 , 但 在 不 同 的 分 文中 ， 即 oauth2 分 文 (https://github.cony 
piomin/sample-spring-cloud-security/tree/oauth2) 。 授 权 服 务 器 在 auth-service 模块 下 可 用 。 

以 下 是 auth-service 的 main 类 。 

QSpringBootApplication 


QEnableAuthorizationServer 
public Class AuthApplication 1{ 


public static void main(Sstring[] args) 1{ 
new 
SpringApplicationBuilder (AuthApplication.class) .web (true) .run(args); 


} 
以 下 是 应 用 程序 配置 设置 的 万 段 。 除 了 客户 端的 ID 和 机 密 之 外 ， 我们 还 设置 了 默认 
范围 并 为 整个 项 目 局 用 了 基本 安全 性 。 


security: 
USe : 
name: root 
password: password 
oauth»2: 
ol 
client-1lid: piotr.minkowsk1i 
client-secret: 123456 
scope: read 


运行 授权 服务 之 后 ， 我 们 就 可 以 执行 一 些 测试 。 例 如 ， 可 以 调用 POST /oauth/token 
方法 ， 以 便 使 用 资源 所 有 者 密码 凭据 创建 访问 令 牌 ， 惑 像 在 以 下 命令 中 一 样 。 


$ curl piotr.minkowski:123456@localhost:9999/o0auth/token -da 
grant type=password -d username=root -d password=password 
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开发 人 员 还 可 以 通过 从 Web 浏览 露 调 用 GET /oauth/authorize 端点 来 使 用 授权 代码 

http://localhost:9999/o0auth/authorize?response type=tokeng 

client id=piotr.minkowski&redirect uri=http://example.com&scope=read 

之 后 ， 开 发 人 员 将 被 重 定向 到 如 图 12.4 所 示 的 批准 页 面 。 现 在 可 以 确认 操作 并 最 终 
获得 访问 令 牌 。 它 将 被 发 送 到 初始 请 求 的 redirect_uri 参数 中 传递 的 回调 URL。 以 下 是 笔 
者 在 测试 后 收 到 的 示例 回复 。 


http://example.com/#access token=ddi136a4a-1408-4f3f-p3ca-43dcc05e6df0& 
token type=bearergexplires 1n=43200. 


. QC 个 (i) localhost:9999/0auth/authorize?response_type=token 


OAuth Approval 


Do you authorize 'piotr.minkowski' to access your protected resources? 
es scope.read: 号 Approve Deny 


| Authorize | 


124 OAuth 批准 页 面 


application.yml 文件 中 提供 的 相同 OAuth2 配置 也 可 以 按 编 程 的 方式 实现 。 为 了 达到 
这 个 目的 ， 开 发 人 员 应 该 声明 实现 AuthorizationServerConfigurer 的 任何 @Beans。 其 中 之 
一 是 AuthorizationServerConfigurerAdapter 适 配 需 ， 它 提供 了 衬 方 法 ， 人 允许 创建 以 下 独立 
配 首 茧 的 不 同 定 义 。 
口 ClientDetailsServiceConfigurer: 这 定义 了 客户 端详 细 信 息 服 务 。 可 以 初始 化 客户 
站 详细 信息 ， 也 可 以 只 引用 现 有 存储 。 
口 AuthorizationServerSecurityConfigurer: 这 定义 了 令 牌 六 点 /oauth/token key 和 
/oauth/check token 的 安全 约束 。 
口 ”AuthorizationServerEndpointsConfigurer: 这 定义 了 授权 和 令 牌 端点 以 及 令 牌 服务 。 
这 种 授权 服务 器 实现 的 方法 为 开发 人 员 提 供 了 更 多 机 会 。 例 如 ， 可 以 使 用 有 D 和 密码 
定义 多 个 客户 端 ， 如 以 下 代码 片段 所 示 。 下 文 将 介绍 一 些 更 高 级 的 示例 。 
QConfiguration 


QEnableAuthorizationServer 
public class AuthServerConfig extends AuthorizationServerConfigqgurerAdapter 
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aQOverride 
public Vvoid configqure (AuthorizationServerSecurityConfigurer 
oauthServer) throws ExcCceptjon 1{ 
oauthServer 
-tokenKeyAccess ("permitAll()") 
.CheckTokenAccess(" "isAuthenticated(})™);} 


Override 
public void confjgure (ClientDetailsServiceConfigurer clients) throws 
Exception 1 
clients.inMemory () 
.WithClient{"piotr.minkowski") .secret ("123456") 
.SCOpes ("read"™) 
.authorities ("ROLE CLIENT ) 
-authorizedGrantTypes ("authorization Coqe ， 
"efresh 二 OKen implicit") 
.autoApprove (true) 
.and() 
.WithClient({"john.smith") .secret(" 123456") 
-Copest reaqd, "WIIite | 
.authorities ("ROLE CLIENT ) 
-authorizedocrantTypes ("authorization Coqe ， 
"refresh token”, "jmplicit") 
.autoApprove (true); 


} 
必须 为 授权 服务 器 配置 的 最 后 一 项 是 Web 安全 性 。 在 扩展 WebSecurityConfigurerAdapter 
的 类 中 ， 我 们 定义 了 内 存 中 的 用 户 赁 据 存 储 和 访问 特定 资源 的 权限 ， 如 登录 页 面 。 


QConfiguration 
public class SecurityConfig extends WebSecurityConfigurerAdapter | 


Autowired 
private AuthenticationManager authenticationManager; 


Override 
protected woid configure (HttpSecurity Pttp) throws Exception 1 
http.requestMatchers () 
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.antMatchers("/login™", "/oauth/authorize") 
.andl() 
-authorizeRequests () 
-anyRequest () .authenticated{() 
.andl() 
-formLogin{(}) .permitAll(}; 

} 


Override 
protected woid configure (AuthentijcatijonManagerBuilder auth) throws 
Exceptiion 1{ 
auth.parentAuthenticatijonManager (authenticationManager) 
.lnMemoryAuthentication () 
-WithUser ("piotr.minkowski") .password ("123456") 
.Toles("USERS"); 
} 


12.4.3 ”客户 绵 配置 


应 用 程序 可 以 使 用 以 两 种 不 同方 法 配置 的 OAuth2 客户 端 。 第 一 种 方法 是 通过 
(@EnableOAuth2Client 注解 , 它 将 创建 一 个 ID 为 oauth2ClientContextFilter 的 过 滤器 bean， 
负责 存储 请 求 和 上 下 文 。 它 还 管理 应 用 程序 和 授权 服务 器 之 间 的 通信 。 但 是 ， 我 们 将 要 
讨论 的 却 是 第 二 种 方法 ， 即 通过 @EnableOAuth2Sso 实现 OAuth2 客户 端 。 单 点 登录 (Single 
Sign-On，SSO) 是 一 种 众所周知 的 安全 模式 ， 它 允许 用 户 使 用 一 组 登录 和 凭据 来 访问 多 个 
应 用 程序 。 此 注解 提供 了 两 个 功能 一 一 OAuth2 客户 疹 和 身份 验证 。 刁 份 验证 功能 模块 使 开 
发 人 员 的 应 用 程序 可 以 符合 典型 的 Spring Security 机 制 ( 如 表单 登录 ) 。 客 户 端 模块 则 具有 
与 @EnableOAuth2Client 提供 的 功能 相同 的 特性 。 所 以 ， 天 发 人 员 可 以 将 @EnableOAuth2Sso 
视 为 比 @EnableOAuth2Client 更 高 级 别 的 注解 。 

在 下 面 的 示例 代码 片段 中 ， 我 们 已 经 注解 了 使 用 @EnableOAuth2Sso 扩展 
WebSecurityConfigurerAdapter 的 类 。 由 于 此 扩展 ，Spring Boot 配置 了 带 有 OAuth2 身份 
验证 处 理 程序 的 安全 过 滤器 链 (Security Filter Chain) 。 在 这 种 情况 下 ， 仅 允许 对 /login 
页 面 的 请 求 ， 而 所 有 其 他 请 求 都 需要 号 份 验证 。 可 以 使 用 security.oauth2.sso.login-path 属 
性 覆盖 表单 登录 页 面 路 往 。 在 覆 冀 它 之 后 ， 开 发 人 员 还 应 该 记得 在 WebSecurityConfig 中 
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更 改 路 径 模式 。 


QConfiguration 
EnableOAuth2Sso 
Public class WebSecurityContig extends WebSecurityConfigqurerAdapter 1{ 


Override 
protected void configure (HttpSecurity Phttp) throws Exception 1{ 
http.antMatcher ("/**") 
-authorizeRequests () 
.antMatchers ("/login**"™) 
.PermitAll'() 
-anyReduest () 
-authenticated(); 


} 


还 有 一 些 需 要 设置 的 配置 设置 。 首 先 ， 应 该 禁用 基本 身份 验证 ， 因 为 我 们 已 经 局 用 
了 表单 登录 方法 和 @EnableOAuth2Sso 注解 。 然 后 ， 必 须 提供 一 些 基 本 的 OAuth2 客户 庙 
属性 ， 如 客户 端 凭据 和 授权 服务 器 公开 的 HITP API 端点 的 地 址 。 


Security: 
basic: 
enabled: false 
oauth2: 
client: 
clientId: piotr.minkowski 
clientSecret: 123426 
accessTokenUri: http://localhost:9999/0auth/token 
userAuthorizationUri: http://localhost:9999/0auth/authorize 
resource: 
userInfoUri: http://localhost:9999/user 


application.yml 文件 片段 中 的 最 后 一 个 属性 是 security.oauth2.resource.userInfoUri， 它 
需要 服务 堪 端 的 其 他 疹 点 。 通 过 UserController 实现 的 端点 将 返回 java.security.Principal 
对 象 ， 指 示 当 前 经 过 身份 验证 的 用 户 。 


QRestController 
public class UserController 1 


RequestMapping ("/user") 
Public Principal user{(Principal user) { 
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return user; 


现在 ， 如 有 果 调 用 由 我 们 的 某 个 微服 务 公 开 的 任何 端点 ， 都 将 自动 重 定 癌 到 登录 页 面 。 
由 于 我 们 为 内 存 客 户 问 的 详细 信息 存储 设置 了 autoApprove 选项 , 因而 将 目 动 生成 授予 的 
权限 和 访问 令 牌 ， 而 无 须 用 户 进 行 任何 交互 。 在 登录 页 面 提供 凭据 后 ， 开 发 人 员 应 该 从 
请 求 的 资源 处 获得 啊 应 。 


12.4.4 ”使 用 JDBC 后 端 存储 


在 前 面 的 小 节 中 ， 我 们 配置 了 一 个 号 份 验证 服务 器 和 客户 端 应 用 程序 ， 它 授予 对 资 
源 服务 器 进行 保护 的 资源 的 访问 权限 。 但 是 ， 整 个 授权 服务 器 配置 已 在 内 存 中 提供 。 这 
种 解决 方案 在 开发 过 程 中 满足 了 我 们 的 需求 ， 但 在 生产 模式 中 却 不 是 最 理想 的 方法 。 目 
标 解决 方案 应 将 所 有 喘 份 验证 凭据 和 令 牌 存储 在 数据 库 中 。 开 发 人 员 可 以 在 Spring 文 持 
的 许多 关系 数据 库 之 间 进 行 选择 。 在 本 示例 中 ， 我 们 决定 使 用 MySQL 。 

因此 ， 第 一 步 就 是 在 本 地 局 动 MySQL 数据 库 。 实 现 这 一 目标 的 最 简便 方式 是 通过 
Docker 容器 。 除 了 启动 数据 库 之 外 ， 以 下 命令 还 会 创建 一 个 模式 ‘Schema) 和 一 个 名 为 
oauth2 的 用 户 。 

docker run -d --name mysql -e MYSQL DATABASE=oauth2 -e MYSQL USER=oauth2 -e 

MYSQL PASSWORD=0auth2 -e MYSQL ALLOW EMPTY PASSWORD=Yyes -P 33306:3306 mysqgl 

一 旦 局 动 了 MySQL， 现 在 必须 在 客户 冰 提 供 连 接 设 置 。 如 果 开 有 人 员 是 在 Windows 
机 器 和 端口 33306 上 运行 Docker， 则 MySQL 在 主机 地 址 192.168.99.100 下 可 用 。 数据 源 
属性 应 在 auth-service 的 application.yml 文件 中 设置 。Spring Boot 还 能 够 在 应 用 程序 局 动 
时 在 所 选 数 据 源 上 运行 一 些 SQL 脚本 。 这 对 开 必 人 员 来 说 是 一 个 好 消 轧 ， 因 为 我 们 必须 
在 专用 于 OAuth2 流程 的 架构 上 创建 一 些 表 。 

SpIring: 

application: 

name: auth-service 

datasource.: 

url: jdbc:mysql://192.168.99.100:33306/0auth2?useSSsL=false 
username: oauth2 


password: oauth2 
driver—-class-name: com.mysgql .Jdbc.Driver 
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Schema: classpath:/script/schema.sql 
data: classpath:/script/data.sql 


己 创 建 的 模式 包含 一 些 用 于 存储 OAuth2 凭据 和 令 有 牌 的 表 ， 如 tokens-oauth_client_ 
details、 oauth client token、oauth access token、 oauth refresh token、oauth code 和 oauth 
approvals。 此 外 ， 在 /src/main/resources/script/schema.sql 中 还 提供 了 带 有 SQL 创建 命令 的 
完整 脚本 。 

实际 上 上， 还 有 第 二 个 SQL 脚本 (src/main/resources/script/data.sql1)， 它 和 之 有 一 些 用 
于 测试 用 途 的 insert 命令 。 最 重要 的 是 添加 一 些 客户 端 ID/ 客 己 并 密 钥 对 。 


INSERT INTIO oauth client details ( client id , client secret , scope ， 
‘authorized grant types , access token validity ， 

‘additional information ) VALUES ('piotr.minkowski', '123456', 'read', 
'authorization code,password,refresh token,implicit"', '900°', '{}"'); 
INSERT INTO ‘oauth client details ( client Id , client secret , scope ， 
‘authorized grant types , access token validity ， 

‘additional information ) VALUES ('john.smith', '123456', 'write', 
'authorization code,password,refresh token,implicit', '300', '{}"'); 


当前 版 本 的 身份 验证 服务 器 与 基本 示例 中 摘 述 的 版 本 之 间 存 在 一 些 实现 上 的 差异 。 
这 里 最 重要 的 事情 是 将 默认 令 牌 存储 设置 为 数据 库 ， 方 法 是 提供 一 个 以 默认 数据 源 作 为 
参数 的 JdbcTokenStore bean。 虽然 所 有 令 牌 现在 都 存储 在 数据 库 中 , 但 我 们 仍然 希望 以 JWT 
格式 生成 它们 。 这 就 是 为 什么 必须 在 该 类 中 提供 第 二 个 bean JwtAccessTokenConverter 的 原 
因 。 通 过 窗 新 从 基 类 继承 的 不 同 configure 方法 ， 开 发 人 员 可 以 为 OAuth2 客户 端详 细 信 
恩 设 置 默 认 存 储 ， 并 将 授权 服务 器 配置 为 始终 验证 在 HTTP 标 头 中 提交 的 API 密 钥 。 


QConfiguration 
QEnableAuthorizationServer 
Public class OAuth2Config extends AuthorizationServerConfigqurerAdapter 1 


Autowired 

private DataSouTrce dataSource; 

QAutowired 

private AuthenticationManager authenticationManager; 


Override 
Publicvoid confiqure (AuthorizationServerEndpointsConftigqurer endpoints) 
throws Exception 1 
endpoints.authenticationManager (this.authenticationManager) 
.tokenstore (tokenSstore())} 
.aCCessTokenConverter(laccessTokenConverter()); 
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} 
Override 
public Void configqgure (AuthorizationServerSecurityConfigurer 
oauthServer)} throws Exception 1 


oauthSserver.checkTokenAccess ("permtAll(})"}; 


Bean 
public JwtAccessTokenConverter accessTokenConverter() 1{ 


return new JwtAccessTokenConverter(); 


Override 
public void confiqure (ClientDetailsServiceConfigurer clients) throws 


Exception 1{ 
clients.dbc(datasource}); 


QBean 
public JdbcTokenstore tokenstore() 1{ 
return new JdbcTokenstore (dataSource}); 


} 
Spring 应 用 程序 可 以 提供 自 定 义 的 身份 验证 机 制 。 要 在 应 用 程序 中 使 用 它 ， 必 须 实 


现 UserDetailsService 接口 并 履 辣 其 loadUserByUsermame 方法 。 在 我 们 的 示例 应 用 程序 中 ， 
用 户 凭 据 和 权限 也 存储 在 数据 库 中 ， 因 而 需要 将 UserRepository bean 注入 目 定 义 


UserDetailsService 类 。 


QComponent ("userDetailsService") 
Public class UserDetalillsServiceImpl implements UserDetailsService | 


private final Logger log 
LoggerFactory.getLogger (UserDetailsServiceImpl.class); 


@Autowired 
private UserRepository userRepository; 


ROverride 
RTransactional 
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public UserDetails loadUserByUsername (final String login) 1 
log.debug{("Authenticating {}", login); 
String lowercaseLogin = login.toLowerCase () ; 
User userFromDatabase; 
if(lowercaseLogin.contains ("Q")) 1 
userFromDatabase = userRepository.findByEmail (lowercaseLogin); 
|} else 1 
userFEromDatabase = 
userRepository.findByUsernameCaselnsensitive (lowercaseLogin); 
} 
It (userFromDatabase == null) I 
throw new UsernameNotFoundExceptionl("User " + lowercaseLogin + 
”Was not found in the database™);} 
} else if (IuserFromDatabase.isActivated(})}) 1 
throw new UserNotActivatedExceptijon("User "+ lowercaseLogin + 
“1s not activated™}; 
} 
Collection<GrantedAuthority> grantedAuthorities = new 
ArrayList<>(}); 
for (Authority authority : userFromDatabase.getAuthorities{(}) { 
GrantedAuthority grantedAuthority = new 
SimpleGrantedAuthority (authority.getName () ) : 
grantedAuthorities.add (grantedAuthority); 
} 
return new 
org .springframework.security.core.userdetails .User (userFromDatabase. 
getUser name(), userFromDatabase.getPassword(), grantedAuthorities).; 


12.4.5 ”服务 间 授 权 
使 用 Feign 客户 端 即 可 实现 本 示例 中 的 服务 间 通 信 。 以 下 是 我 们 所 选 的 实现 之 一 (这 
里 选择 的 是 本 示例 中 的 order-service 服务 ) ， 它 将 调用 来 自 customer-service 服务 的 端点 。 


QFeignClient (name = "customer-service") 
Public interface CustomerClient | 


GetMapping("/withAccounts/{customerId}") 
Customer findByIdWithAccounts (QPpathVariable ("customerId") Long 
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customerId); 


} 

与 其 他 服务 一 样 , 来自 customer-service 服务 的 所 有 可 用 方法 都 受到 基于 OAuth 令 牌 
范围 的 预 授权 机 制 的 保护 。 它 允许 开发 人 员 使 用 @PreAuthorize 注解 每 个 方法 ， 定 义 所 需 
的 范围 。 


QQPFreaAuthorize("#oauth2 .hasScope ("write")™) 


QPutMapping 
Public Customer update (RequestBody Customer customer) { 
refurn TepOSILOrY .UIPdate tecustomer})e: 


QGPreAuthorize ("#0o0auth2.hasscope ("read")™) 

QQGGetMapping ("/withAccounts/{iqd}") 

public Customer findByIdWithAccounts (QPathVariable ("id") Long id) throws 

JsonProcessingException | 

List<Account> accounts = accountClient.findBycCustomer (id); 
LOGGER.info("Accounts found: {}", mapper.writeValueAsSstring (accounts) )}; 
CuSstomer cc = repository.findById(id)}; 

c.SetAccounts (accounts);} 

retnurn Cs 

} 

时 认 情况 下 预 授权 机 制 是 被 禁用 的 。 要 为 API 方法 启用 它 ， 应 该 使 用 
@EnableGlobalMethodSecurity 批注 。 开 发 人 员 还 应 该 指出 这 样 的 预 授权 将 基于 OAuth2 
令 牌 范围 。 

QConfiguration 

QEnableResourceServer 

QEnableGlobalMethodSsecurity (prePostEnabled = true) 


public class OAuth2ResourceServerConfig extends 
GlobalMethodSecurityConfiguration 1 


ROverride 


protected MethodSecurityExpressionHandler createExpressilonHandler(}) 1 
return new OAuth2MethodSecurityExpressionHandler(); 


} 
如 果 通 过 Feign 客户 端 调用 account-service 服务 端点 ， 则 会 出 现 以 下 异 第 。 
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feign.FeignExceptijion: status 401 reading 
CustomerClient#IfindByIdWithAccounts (); 

content:{ error”: nauthorized .error description: 

“Full authentication 1is regquired to access this resource"]} 


为 什么 会 出 现 这 种 异常 呢 ” 当 人 然 , customer-service 服务 受 OAuth2 令 牌 授权 保护 ,但 
Feign 客户 端 不 会 在 请 求 标 头 中 发 送 授权 令 牌 。 可 以 通过 为 Feign 客户 端 定义 目 定 义 配 置 
类 来 和 目 定 义 该 方法 。 它 允许 开发 人 员 声 明 一 个 请 求 拦截 器 。 在 这 种 情况 下 ， 可 以 使 用 来 
目 Spring Cloud OAnuth2 库 的 OAuth2FeignRequestInterceptor 提供 的 OAuth2 实现 。 出 于 测 
试 目 的 ， 笔 者 决定 使 用 资源 所 有 者 密码 授予 类 型 。 


public class CustomercCclientConfiguration 1{ 


QValue ("$s{security.oauth2.client.access—-token—uri}") 
private String accessTokenUri; 

QValue ("$s${security.oauth2.client.client—-id}™") 
private String clientlId; 

QValue ("$s{security.oauth?2.client.client-secret}") 
private String clientSecret, 

QValue ("$s{security.ocoauth?2.client.scope}") 

private String Scopes 


Bean 
RequestInterceptor oauth2FelIgnReduestIntercCceptor () 1{ 
return new OAuth2FeignRequestInterceptor (new 
DefaultoOAuth2ClientContext (), resource ());} 
} 


aBean 
Logger.Level feignLoggerLevel () | 
return Logger.Level .FULL; 


private OAuth2ProtectedResourceDetails resource() 1 

ResourceOwnerPasswordResourceDetalils resourceDetalills = new 

ResourceOwnerPasswordResourceDetails (); 
resourceDetails.setUsername ("root™); 
resourceDetalils.setPassword("password"); 
resourceDetails.setAccessTokenUri (accessTokenUri);} 
resourceDetalils.setcClientId(clientId)}),; 
resourceDetails.setClijentSsecret (clientSecret)}),} 
resourceDetalils.setGrantType ("password"); 
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resourceDetalils.setScope (Arrays .asList (scope}) }); 
return resourceDetalls; 


} 


最 后 ， 我 们 可 以 测试 己 经 实现 的 解决 方案 。 这 一 次 ， 我 们 将 创建 一 个 JUnit 自动 化 测 


试 ， 而 不 是 在 Web 浏览 右 中 单 击 它 或 使 用 其 他 工具 发 送 请 求 。 测 试 方法 显示 在 以 下 代码 
段 中 。 开 发 人 员 可 以 使 用 OAuth2RestTemplate 和 ResourceOwnerPasswordResourceDetails 
来 执行 资源 所 有 者 凭据 授权 操作 ， 并 使 用 请 求 标 头 中 发 送 的 OAuth2 令 牧 从 order-service 
服务 调用 POST /API 方法。 当然， 在 运行 该 测试 之 前 ， 必 须 局 动 所 有 微服 务 ， 以 及 发 现 


和 授权 服务 占 。 


@Test 
Public void testClient() | 
ResourceOwnerPpasswordResourceDetails resourceDetails = new 


ResourceOwnerPasswordResourceDetalils (); 
resourceDetails.setUsername ("root™); 
resourceDetalils.setPassword("password"); 


resourceDetails.setAccessTokenUri ("http://localhost:9999/o0auth/token™".);} 


resourceDetalls.setClientId("piotr.minkowski” )}):; 

resourceDetails.setcCclientSecret ("123456"™");，; 

resourceDetails.setGrantType( "password }); 

resourceDetails.setScope (Arrays.asList("read™)}))}); 

DefaultOAuth2ClientContext clientContext = new 
DefaultOAuth2ClientContext () ， 

OAuth2RestTemplate restTemplate = new 
OAuth2RestTemplate (resourceDetails, clientContext); 

restTemplate.setMessageConverters (Arravs .asList (new 
MappingJackson2HttpMessageConverter())); 

Random r = new Random(); 

Order order = new Order(); 

ordersetCustomerIld({(long} Ir.nextIint(3) + 1); 

order.setProductlIds (Arrays.asList (new Longl[|] 1 
(long) Ir.nezxtIint{(10) + 1; (long) r.nextInt(10) + 1 1})}s; 


order = restTemplate.postForObject ("http://localhost:8090", order, 


Order.class); 
i (order.getstatus({} = Orderstatus.REJECTED) 1 
restTemplate.put ("http://localhost:8090/{id}", null, 
order.getId()}))}); 
} 
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12.4.6 在 API 网 关上 局 用 SSO 


开发 人 员 可 以 通过 使 用 @EnableOAuth2Sso 注解 main 类 来 启用 API 网 关上 的 单 点 登 
录 功 能 。 实 际 上 ， 这 是 微服 务 架 构 的 最 佳 选 择 ， 它 可 以 强制 使 Zuul 为 当前 经 过 吴 份 验证 
的 用 户 生成 或 获取 访问 令 牌 。 

QSpringBootApplication 

EnableOaAuth2Sso 


QEnablezuulProxy 
public class GatewayApplication | 


public static void main(sString[|] args) 1 
new 
SpringApplicationBuilder (GatewayApplication.class) .web (true) .run(args}); 


} 
} 


通过 包含 @EnableOAuth2Sso， 可 以 触发 ZuulFilter 的 自动 配置 。 过 滤器 负责 从 当前 
经 过 里 份 验证 的 用 户 提 取 访 问 令 牌 ， 然 后 将 其 放 入 请 求 标 头 中 ， 并 转发 到 隐 叱 在 网 关 后 
面 的 微服 务 中 。 如 果 为 这 些 服务 激活 了 (@EnableResourceServer， 它 们 将 在 Authorization 
HTTP 标 头 中 接收 预期 的 令 和 脾 。 可 以 通过 声明 proxy.auth.* 属 性 来 控制 @EnableZuulProxy 
下 游 的 授权 行为 。 
在 架构 中 使 用 网 关 时 , 可 能 会 隐 洗 其 后 面 的 授权 服务 器 。 在 这 种 情况 下 , 应 该 在 Zuul 
的 配置 设置 中 提供 其 他 路 由 ， 如 uaa。 然 后 ，OAnuth2 客户 端 和 服务 器 之 间 交 换 的 所 有 消 
县 都 将 通过 网 关 。 以 下 是 网 关 的 application.yml 文件 中 的 正确 配置 。 
Security: 
oauth2: 
client: 
accessTokenUri: /uaa/oauth/token 
userAuthorizationUri: /uaa/oauth/authorize 
clientId: pliotr.minkowsk1 
clientSecret: 123456 


resource: 
userInfoUri: http://localhost:9999/user 


ml = 
IOuUutes: 
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aCCoUnt 一 SerVlice : 
path: /account/** 
customer—service: 
path: /customer/** 
妆 正 本 导 下 一 呈 司 让 丰 下 在 革 
path: /order/** 
Product—~—service: 
path: /product,/** 
uaa: 
sensitiveHeaders: 
path: /uaa/** 
url: http://localhost:9999 
add—proxy-headers: true 


12.9 小 结 


本 章 是 专门 开辟 的 一 个 关于 安全 主题 的 章节 ， 以 按 步 又 详细 介绍 如 何 保护 基于 微服 
务 的 架构 的 关键 元 素 。 与 安全 相关 的 主题 通常 比 其 他 主题 更 高 级 ， 因 此 ， 笔 者 花 了 一 些 
时 间 来 解释 该 领域 的 天干 基本 概念 。 本 章 通 过 示例 说 明了 双 同 SSL 喘 份 验证 、 敏 感 数据 
的 加 密 / 解 密 、Spring Security 号 份 验证 以 及 使 用 JWT 令 牌 的 OAuth2 授权 。 全 于 在 染 构 
中 应 该 使 用 哪些 组 件 才 能 提供 所 需 的 安全 级 别 ， 将 由 开发 人 员 目 己 来 决定 。 

在 阅读 完 本 章 之 后 ， 开 发 人 员 应 该 能 够 为 应 用 程序 设置 基本 和 更 高 级 的 安全 配置 。 
此 外 ， 还 应 该 能 够 保护 系统 架构 的 每 个 组 件 。 当 然 ， 本 章 只 讨论 了 一 些 可 能 的 解决 方案 
和 框架 。 例 如 ， 不 必 仅 依赖 Spring 作为 授权 服务 器 提供 程序 ， 我 们 也 可 能 会 使 用 第 三 方 
工具 ， 如 Keycloak， 它 可 以 充当 基于 微服 务 的 系统 中 的 授权 和 里 份 验证 服务 器 。 它 还 可 
以 很 轻松 地 与 Spring Boot 应 用 程序 集成 。 它 六 持 所 有 最 流行 的 协议 ， 如 OAuth2、OpenId 
Connect 和 SAML。 事 实 上 ，Keycloak 是 一 个 非常 强大 的 工具 ， 应 该 被 视 为 Spring 授权 
服务 器 的 蔡 代 品 ， 特 别 是 对 于 大 型 企业 系统 和 其 他 更 高 级 的 用 例 而 言 更 是 如 此 。 

第 13 章 将 讨论 微服 务 测试 的 不 同 策略 。 


第 13 章 测试 Java 微服 务 


在 开发 新 应 用 程序 时 ， 我 们 也 不 应 该 扎 记 目 动 化 测试 。 如 果 考 虑 使 用 基于 微服 务 的 
架构 ， 这 些 则 特别 重要 。 测 试 微 服务 所 需要 采用 的 方法 与 测试 一 体 化 应 用 程序 所 采用 的 
方法 不 同 。 束 一 体 化 应 用 程序 而 言 ， 主 要 关注 的 是 单元 测试 和 集成 测试 ， 以 及 数据 库 层 。 
而 在 微服 务 的 情况 下 ， 最 重要 的 是 以 尽 可 能 最 细 的 粒度 为 每 个 通信 提供 履 盖 。 虽 然 每 个 
微服 务 都 是 独立 开发 和 发 布 的 ， 但 其 中 一 个 微服 务 的 更 改 可 能 会 影 啊 与 该 服务 交互 的 所 
有 其 他 服务 。 它 们 之 间 的 通信 是 通过 消息 实现 的 。 一 般 来 说 , 这 些 是 通过 REST 或 AMQP 
协议 发 送 的 消息 。 

本 章 将 要 讨论 的 主题 包括 : 


UU 


UUU 


Spring 的 目 动 化 测试 文 持 。 

Spring Boot 微服 务 的 组 件 和 集成 测试 之 间 的 差异 。 
使 用 Pact 实现 契约 测试 。 

使 用 Spring Cloud Contract 实现 契约 测试 。 

使 用 Gatling 实现 性 能 测试 。 


13.1 测试 策 辐 


有 5 种 不 同 的 微服 务 测试 策略 ， 前 3 个 策略 与 一 体 化 应 用 程序 相同 。 


加 


UU 


单元 测试 (Unit Test) : 通过 单元 测试 ， 开 发 人 员 可 以 测试 最 小 的 代码 片段 ， 例 
如 ， 单 个 方法 或 组 件 ， 并 模拟 其 他 方法 和 组 件 的 每 次 调用 。 有 许多 流行 的 框架 
均 支 持 Java 中 的 单元 测试 ， 如 JUnit、TestNG 和 Mockito 〈 用 于 模拟 ) 。 此 类 测 
试 的 主要 任务 是 确认 实现 符合 要 求 。 单 元 测试 可 以 是 一 个 强大 的 工具 ， 尤 其 是 
与 测试 驱动 开发 模式 相 结合 时 。 

集成 测试 (Integration Test) : 仅 使 用 单元 测试 并 不 能 保证 开发 人 员 可 以 验证 整 
个 系统 的 行为 。 集 成 测试 采用 模块 并 尝试 一 起 测试 它们 。 这 种 方法 使 开发 人 员 
有 机 会 在 子 系统 中 测试 通信 路 径 。 我 们 将 测试 组 件 之 间 的 交互 和 通信 ， 这 些 组 
件 基 于 与 模拟 的 外 部 服务 的 接口 。 在 基于 微服 务 的 系统 中 ， 可 以 使 用 集成 测试 
以 包括 其 他 微服 务 、 数 据 源 或 高 速 缓存 。 

疹 到 应 测试 〈End-to-End Test) : 应 到 应 测试 也 称 功能 测试 〈Function Test) 。 
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这 些 测试 的 主要 目标 是 验证 系统 是 否 满足 外 部 要 求 。 这 意味 着 我 们 应 该 设计 测 
试 方 案 来 测试 参与 该 过 程 的 所 有 微服 务 。 良 好 的 端 到 问 测 试 设 计 并 非 易 事 。 由 
于 我 们 需要 测试 整个 系统 ， 因 而 特别 强调 测试 的 方案 设计 非常 重要 。 

契约 测试 〈Contract Test) : 契约 测试 用 于 确保 微服 务 的 显 式 和 隐 式 契约 按 预 期 
工作 。 当 使 用 者 与 组 件 的 接口 集成 以 便 使 用 它 时 ， 总 是 形成 契约 。 通 向， 在 基 
于 微服 务 的 系统 中 ， 存 在 单个 组 件 的 许多 使 用 者 。 他 们 每 个 人 通 前 都 需要 一 份 
满足 其 要 求 的 不 同 契 约 。 遭 循 这 些 假设 ， 每 个 使 用 者 都 负责 源 组 件 的 接口 行为 。 
组 件 测试 CComponent Test) : 在 完成 微服 务 中 所 有 对 象 和 方法 的 单元 测试 之 后 ， 
开发 人 员 应 该 单独 测试 整个 微服 务 。 为 了 单独 运行 测试 ， 开 发 人 员 需 要 模拟 
(Mock) 或 桩 〈Stub) 其 他 微服 务 的 调用 。 外 部 数据 存储 应 蔡 换 为 等 效 的 内 存 
数据 存储 ， 这 也 提供 了 显著 的 测试 性 能 改进 。 


浪 约 测试 和 组 件 测 试 之 间 的 差异 是 显而易见 的 。 图 13.1 说 明了 我 们 的 示例 order-service 


微服 务 中 契约 测试 和 组 件 测 试 之 间 的 差异 。 


| |Product Service 桩 


Product Service ' 


; 区 Controller OrderController , 
| 
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图 13.1 四 约 测试 和 组 件 测试 之 间 的 差异 
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现在 , 有 一 个 问题 是 : 我 们 是 否 确 实 需要 两 个 额外 的 策略 来 测试 基于 微服 务 的 系统 ? 
通过 适当 的 单元 和 集成 测试 ， 开 发 人 员 就 可 以 确认 组 成 微服 务 的 各 个 组 件 的 实现 是 否 正 
确 。 但 是 ， 如 果 没 有 针对 微服 务 的 更 具体 的 测试 策略 ， 开 有 人员 将 无 法 确定 它们 如 何 协 
同 工 作 以 满足 业务 需求 。 
因此 ， 我 们 增加 了 组 件 测试 和 契约 测试 。 这 是 一 个 非 浊 重要 的 变化 ， 它 可 以 帮助 我 
们 理解 组 件 测 试 、 契 约 测试 和 集成 测试 之 间 的 差异 。 由 于 组 件 测 试 是 与 外 界 隅 离 进行 的 ， 
因而 集成 测试 将 狄 责 验 证 与 该 世界 的 交互 。 这 就 是 为 什么 我 们 应 该 为 组 件 测试 提供 桩 以 
进行 集成 测试 。 契 约 测 试 很 像 集成 测试 ， 强 调 微服 务 之 间 的 交互 ， 但 是 契约 测试 会 将 微 
服务 视 为 黑 盒 〈Black Box ) 并 仅 验 证 啊 应 的 格式 。 
一 旦 为 微服 务 提供 功能 测试 ， 开 发 人 员 还 应 该 考虑 性 能 测试 (Performance Test) 。 
我 们 将 区 分 以 下 性 能 测试 策略 。 
口 ”负载 测试 (Load Test) : 这 些 测 试用 于 确定 系统 在 正常 和 预期 负载 条 件 下 的 行 
为 。 这 里 的 主要 思想 是 识别 一 些 弱 点 ， 如 啊 应 时 间 延 人 运 、 异 常 中 断 ， 或 者 如 果 
未 正确 设置 网 络 超 时 ， 则 重 试 次 数 过 多 等 。 
口 ”压力 测试 (Stress Test) : 这 些 测 试 将 检测 系统 的 上 限 ， 以 检查 它 在 极 重 人 负载 下 
的 行为 。 除 负载 测试 外 ， 它 还 检查 内 存 泄 漏 、 安 全 问题 和 数据 损坏 。 它 可 能 使 
用 与 负载 测试 相同 的 工具 。 
图 13.2 说 明了 在 系统 上 执行 所 有 测试 策略 的 逻辑 顺序 。 我 们 将 从 最 简单 的 单元 测试 
开始 ， 它 将 验证 软件 的 各 个 小 段 ， 然 后 逐步 经 过 下 一 个 阶段 ， 直 至 最 终 完成 压力 测试 ， 
将 整个 系统 推 癌 极限 。 


功能 测试 


单元 测试 | | 组 件 测试 | 一 | 集成 测试 上 | 契约 测试 上 | 端 到 端 测试 


性 能 测试 


压力 测试 | 负载 测试 


图 13.2 在 系统 上 执行 所 有 测试 策略 的 逻辑 顺序 


13.2 ”测试 Spring Boot 应 用 程 友 


正如 第 13.1 节 所 述 ， 在 应 用 程序 测试 中 有 一 些 不 同 的 测试 策略 和 方法 。 前 文 已 经 简 
要 提 到 了 所 有 这 些 理 论 知 识 ， 所 以 现在 我 们 可 以 进入 实际 环节 。Spring Boot 提供 了 一 组 
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有 助 于 实现 目 动 化 测试 的 实用 程序 。 为 了 在 项 目 中 局 用 这 些 功能 ， 必 须 将 spring-boot- 
starter-test 局 动 器 包含 在 依赖 项 中 。 它 不 仅 会 导入 spring-test 和 spring-boot-test 工件 ， 还 
会 导入 一 些 其 他 有 用 的 测试 库 ， 如 JUnit、Mockito 和 AssertJ。 
<dependency> 
<grouplId>org.springframework.boot</groupId> 
<artifactId>spring—boot-starter-test</artifactId> 


<scope>test</scope> 
</dependency> 


13.2.1 构建 示例 应 用 程序 


在 开始 进行 自动 化 测试 之 前 ， 需 要 出 于 测试 目的 而 准备 一 个 示例 业务 逻辑 。 我 们 可 
以 使 用 本 书 前 面 章 节 中 的 相同 示例 系统 ， 但 必须 对 其 进行 一 些 修改 。 到 目前 为 止 ， 我 们 
从 未 使 用 外 部 数据 源 来 存储 和 收集 测试 数据 。 在 本 章 中 ， 为 了 说 明 不 同 策略 如 何 处 理 持久 
性 测试 问题 ， 则 有 必要 这 样 做 。 现 在 ， 每 个 服务 都 应 该 有 目 己 的 数据 库 ， 当 然 ， 在 通常 情 
况 下 , 选择 哪个 数据 库 并 不 重要 .Spring Boot 支持 多 种 解决 方案 ,包括 关系 数据 库 和 NoSQL 
数据 库 。 我 们 决定 使 用 的 数据 库 是 Mongo。 我 们 先 来 了 解 一 下 示例 系统 的 架构 。 几 13.3 显 
示 的 当前 示例 系统 架构 的 模型 束 已 经 考虑 了 在 每 个 服务 中 都 采用 专用 数据 库 的 假设 。 


-一 订单 服务 
一 @ 数据 库 


1 『 有 
bs 


Customer 
Service 


图 13.3 ”当前 示例 系统 架构 的 模型 
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13.2.2 与 数据 库 集成 


为 了 对 我 们 的 Spring Boot 应 用 程序 启用 Mongo 文 持 , 可 以 将 spring-boot-starter-data- 
mongo 启动 器 包 合 在 依赖 项 中 。 该 项 目 提供 了 一 些 有 趣 的 功能 来 简化 与 MongoDB 的 集 
成 。 在 这 些 功能 中 ， 值 得 一 提 的 是 特定 的 主 对 象 映 射 〈Rich Object Mapping ) 一 一 
MongoTemplate， 当然 还 有 对 其 他 Spring Data 项 目 众 所 周知 的 存储 库 编 写 风 格 的 文 持 。 
以 下 是 pom.xml 中 所 需 的 依赖 项 声明 。 

<dependency> 

<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-data-mongodb</artifactId> 
</dependency> 


可 以 使 用 Docker 镜像 轻松 启动 MongoDB 的 实例 。 运 行 以 下 命令 即 可 启动 Docker 
容器 并 在 端口 27017 上 公开 Mongo 数据 库 。 


docker run --name mongo -p 271017:2171017 -中 mongo 


为 了 将 应 用 程序 eg 动 的 数据 源 连接 , 开发 人 员 应 该 覆盖 application.yml 中 的 一 
些 上 自动 配置 设置 。 这 可 以 通过 spring.data.mongodb.* 属 性 来 实现 。 


SPTEImG: 
application: 
name: account—service 
data: 
mongodb: 
host: 192.168.99.100 
Bort: ZZIH0L1 
database: micro 
username: micro 
password: microl23 


前 文 己 经 担 到 了 对 象 映射 功能 。Spring Data Mongo 提供 了 一 些 可 用 于 此 的 注解 。 存 
储 在 数据 库 中 的 每 个 对 象 都 应 该 使 用 @Document 注解 .目标 集 合 的 主键 是 一 个 12 字 节 的 
字符 串 ， 应 该 使 用 Spring Data @Id 在 每 个 映射 的 类 中 指示 。 以 下 是 Account 对 象 实现 的 
代码 片段 。 


QDocument 
public class Account 1{ 


&Iqd 
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private StIring 1id; 

private String number; 
private int balance; 
private String customerId; 


0 


13.3 单元 测试 


前 面 伦 了 较 多 时 间 来 措 述 与 MongoDB 的 集成 。 但是, 测试 持久 性 是 目 动 化 测试 的 关 
键 点 之 一 ， 因 而 正确 配置 它 非 常 重 要 。 现 在 ， 我 们 可 以 继续 进行 测试 的 实现 。Spring Test 
可 以 为 最 典型 的 测试 方案 提供 文 持 ， 如 通过 REST 客户 端 与 其 他 服务 集成 或 与 数据 库 集 
成 。 我 们 有 一 组 库 可 以 让 开发 人 员 轻 松 模拟 与 外 部 服务 的 交互 ， 这 对 于 单元 测试 来 说 尤 

以 下 测试 类 是 Spring Boot 应 用 程序 的 典型 单元 测试 实现 。 我 们 使 用 了 JUnit 框架 ， 
它 是 Java 的 事实 标准 。 这 里 使 用 Mockito 库 来 兰 换 真实 的 存储 库 和 控制 器 及 其 桩 。 这 种 
方法 使 我 们 可 以 轻松 验证 @Controller 类 实现 的 每 个 方法 的 正确 性 。 测 试 与 外 部 组 件 隔离 
进行 ， 这 是 单元 测试 的 主要 假设 。 

QRuNnWith (SpringRunner.class) 


QWebMvcTest (AccountController.class) 


Public class AccountControllerUnitTest 1 
ObjectMapper mapper = new ObjectMapper (); 


Autowired 

MockMvc mvce; 

@MockBean 

AccountRepository repository; 


@Test 
public void testAdd() throws Exception | 
Account account = new Account (1234561890™", 5000, ™]l™)}); 
when (repository.save (Mockito.any (Account .class))) .thenReturn (new 
Account ("1™,"1234561890™, 5000, "1"™)})); 
mvc.perform(post("/") .contentType (MediaType.APPLICATION JSON). 
content (mappe r.writeValueAsstring (account))) 
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-andExpect (status () .isOk ()); 
} 


QTest 
public Vold testWithdraw() throws Exception 1 
Account account = new Account("”1l™, ”234561890”， 523000, 1) 7 
when (repository.findOne("1™)}) .thenReturn(laccount}):; 
when (repository.save (Mockito.any (Account .class))) .thenAnswer (new 
Answer<Account>() I 
QOverride 
public Account answer(InvocationOnMock invocation) throws 
Throwable | 
Account a = linvocation.getArgumentAt (0, Account.class); 


return a; 


}); 
mvc.perform(put ("/withdraw/1/1000")) 
.andExpect (status () .1sok ()) 
.andExpect (content () .contentType (MedilaType.APPLICATION JSON UTE8)) 
.andExpect (jsonPpath("$.balance", is(4000))); 


] 

好 消 轧 是 ， 开 发 人 员 可 以 轻松 地 模拟 Feign 客户 端 通信 【特别 是 在 微服 务 环 境 中 ) 。 
以 下 示例 测试 类 将 通过 调用 account-service 服务 公开 的 端点 来 验证 用 于 提取 资金 的 
order-service 服务 的 端点 。 你 可 能 已 经 注意 到 , 该 端点 又 由 先前 引入 的 测试 类 进行 了 测试 。 
以 下 是 order-service 服务 的 单元 测试 实现 的 类 。 

daRunwWith (SpringRunner.class) 


QWebMvcTest (OraderController .class) 
public class OrderControllerTest (| 


Autowired 

MocKMVC mvce; 

MockBean 

OrderRepository repository; 
MockBean 

AccountClient accountClient; 


@Test 
PubLlic Vvoid testAccept(} throws Exception 1 
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Order order = new Order("l1l", Orderstatus.ACCEPTED, 2000, "1™, "1™, 
null); 


When (repository.findoOone("l1")}) .thenReturn(order}? 
when (accountClient.withdraw (order.getAccountId(), 
order.getPrice(}))}) .thenReturn (new Account (1™, "123", 0)); 


when (repository.save (Mockito.any (Order.class) )) .thenAnswer (new 
Answer<Order>{() I 


QOverride 


Public Order answer (InvocationOnMock jnvocation) throws 
Throwable 1 


Order oo = invocation.getArgumentAt (0, Order.class); 
TeEurn Or 


Fs 


mvc.perform(put ("/1")) 
.andExpect (status () .1sOok ()) 
.andExpect (content () .contentType (MediaType.APPLICATION JSON UTF8)) 
.andExpect (jsonPath ("$.status", is!("DONE"™))); 
} 


13.4 组 件 测 试 


如 果 已 为 应 用 程序 中 的 所 有 关键 类 和 接口 提供 了 单元 测试 ， 则 可 以 继续 进行 组 件 测 
试 。 组 件 测试 的 主要 思想 是 使 用 内 存 中 测试 双 精 度 和 数据 存储 来 实例 化 内 存 中 的 完整 微 
服务 。 这 允许 我 们 跳 过 网 络 连接 。 对 于 单元 测试 ， 我 们 模拟 的 是 所 有 数据 库 或 HTTP 客 
户 端 ， 而 在 组 件 测试 中 我 们 则 不 用 模拟 任何 东西 。 我 们 将 为 数据 库 客户 端 提供 内 存 数据 
源 ， 并 模拟 REST 客户 端的 HTTP 响应 。 


13.4.1 使 用 内 存 数据 库 运 行 测试 


我 们 选择 MongoDB 的 原因 之 一 是 它 可 以 很 容易 地 舱 入 Spring Boot 应 用 程序 以 进行 测 
试 。 要 为 项 目 启用 散 入 式 MongoDB， 可 以 在 Maven 的 pom.xml 文件 中 包含 以 下 依赖 项 。 


<dependency> 
<aqroupId>de.flapdoodle.embed</grouplId> 
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<artifactId>de.flapdoodle.embed.mongo</artifactId> 
<Sscope>test</scope> 
</dependency> 
Spiing Boot 可 以 为 藤 入 式 MongoDB 提供 自动 配置 ， 因 此 ， 除 了 在 application.yml 
中 设置 本 地 地 址 和 奖 口 之 外 ， 我 们 不 需要 做 任何 其 他 事情 。 
因为 ， 在 默认 情况 下 ， 我 们 将 使 用 在 Docker 容器 上 运行 的 Mongo， 我 们 应 该 在 另 一 
个 Spring 配置 文件 中 声明 这 样 的 配置 。 通 过 使 用 @ActiveProfiles 注解 测试 类 ， 在 测试 用 
例 执 行 期 间 激 活 此 特定 配置 文件 。 以 下 是 application.yml 的 一 个 片段 ， 我 们 使 用 不 同 的 
MongoDB 连接 设置 定义 了 两 个 配置 文件 一 一 dev 和 test。 
SpIring: 
profiles: dev 
data: 
mongodb: 
host: 192.168.99.100 
Borts .ZT01L9 
database: milicro 
username: micro 
password: microl23 


Spring: 
profiles: test 
data: 
mongodb: 
host: localhost 
Borts ,2701] 


如 果 使 用 MongoDB 以 外 的 数据 库 ， 如 MySQL 或 Postgeres， 则 可 以 使 用 替代 的 内 存 
中 (In-Memory) 租 入 式 关 系数 据 库 (如 H2 或 Derby) 轻松 蔡 换 它 们 。Spring Boot 文 持 
它们 ， 并 将 为 可 能 使 用 @DataJpaTest 激活 的 测试 提供 自动 配置 。 开 发 人 员 也 可 以 使 用 
(@DataMongoTest 注解 来 艇 入 MongoDB， 而 不 是 使 用 @SpringBootTest。 除 了 内 存 中 的 骸 
入 式 MongoDB， 它 还 将 配置 MongoTemplate， 扫 描 @Document 类 ， 并 配置 Spring Data 
MongoDB 存储 库 。 


13.4.2 处理 HTTP 客户 端 和 服务 发 现 


虽然 关于 使 用 内 存 中 数据 库 测 试 持久 性 的 问题 己 得 到 解决 ， 但 是 ， 我 们 仍 需要 考虑 
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测试 的 其 他 方面 ， 如 模拟 来 自 其 他 服务 的 HTTP 啊 应 或 网 集 成 。 当 开发 人 员 为 
微服 务实 现 菜 些 测试 时 ， 可 以 选择 两 种 典型 的 服务 发 现 方法 。 第 一 个 是 在 测试 用 例 执行 
期 间 将 发 现 服务 器 艇 入 应 用 程序 ， 第 二 个 是 在 客户 端 禁用 发 现 。 i Spring Cloud 配置 
第 二 个 选项 相对 容易 。 对 于 Eureka Server 来 说 ， 可 以 使 用 eureka.client.enabled = false 属 
性 禁用 它 。 

这 只 是 练习 的 第 一 部 分 。 我 们 还 应 该 禁用 Ribbon 客户 端的 发 现 ， 该 客户 端 负责 在 服 
务 间 通信 中 进 和 负载 均衡 。 如 果 有 多 个 目标 服务 ， 则 必须 使 用 服务 名 称 标记 每 个 客户 端 。 
以 下 配置 中 的 最 后 一 个 属性 listOfServers 的 值 与 用 于 自动 化 测试 实现 的 框 架 严 格 相 关 。 接 
下 来 我 们 将 演示 基于 Hoverfly Java 库 的 示例 (该 库 在 本 书 第 7 章 “ 高 级 负载 均衡 和 断路 
器 ”中 已经 介绍 过 ) ， 然 后 使 用 它 来 模拟 调用 目标 服务 的 延 运 ， 以 便 显 示 Ribbon 客户 端 
和 Hystrix 如 何 处 理 网 络 超时 。 在 这 里 ， 我 们 将 使 用 它 来 返回 准备 好 的 啊 应 ， 以 使 我 们 的 
组 件 测试 触及 网 络 通信 。 以 下 是 配置 文件 的 一 个 片段 , 其 中 的 配置 选项 将 负责 禁用 Eureka 
的 发 现 ， 并 设置 Ribbon 客户 端的 测试 属性 。 此 外 ， 还 应 该 通过 使 用 @ActiveProfiles 注解 
来 为 测试 类 激活 该 配置 文件 。 


SprIing: 
profiles: nodiascovery 
eureka: 
cilient: 
enabled: false 
account—service: 
ribbon: 
SuUreka: 
enable: false 
liSsTOFServers: CCoUnNnt service:8080 
cuUStomer—SsService: 
ribbon: 
eureka: 
enable: false 
1istoOfServers: CUStomer Service:8080 
product— service: 
ribbon: 
eureka: 
enable: false 
listOfServers: product—service:8080 


我 们 不 想 深入 探讨 Hoverfly or 因为 本 书 第 7 章 “高 级 负载 均衡 和 断路 器 ” 
对 其 已 经 介绍 过 。 如 前 文 所 述 ， 可 以 通过 声明 使 用 HoverflyRule 的 @ClassRule 来 激活 
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Hoverfly 以 进行 JUnit 测试 ， 定 义 应 该 模拟 的 服务 和 端点 列表 。 每 个 服务 的 名 称 必 须 与 使 
用 listOfServers 属性 定义 的 地 址 相同 。 以 下 是 Hoverfly 测试 规则 的 定义 ， 该 规则 将 模拟 
来 日 3 种 不 同 服务 的 啊 应 。 


QClassRule 
public static HoverflyRule hoverflyRule = HoverflyRule 

.1nSimulationMode (dsl il 
SeErvice("account—service:8080"™) 

.PuUt (startsWith ("/withdraw/")) 
.WilljReturn(success{("{\"id\"™:\"1\", \"number\"™: \"1234567890\", 
\"balance\™:5000}", "application/json"™)), 
Servicel("customer-service:8080"™) 

.get ("/withAccounts/1") 

.WillReturnl(lsuccess("{\"id\":\"{{ Request.Path. [1] 

] jnamevn: NTestl \"type\":\"REGULAR\", \"accounts\": [{NM"idM™:\"1I\", 
\™ number\":\"12345671890\",\"balance\":5000}]}", "application/json")), 

SErVvVIice( Product— service:BO0B0) 

.Dost ("/ids") .anyBody () 

.willReturn{(success{("[T{\"id\™":\"1\", "name\": \"Test1l\", 
"price\™:1000}]™", "application/json"})}})} 

-printSimulationData(}; 


13.4.3 ”实现 示例 测试 


为 了 验证 在 上 两 节 中 己 经 提出 过 的 结论 ， 现 在 可 以 使 用 内 存 中 髓 入 式 MongoDB、 
Hoverfly 模拟 HTTP 啊 应 〉 和 禁用 服务 发 现 来 准备 组 件 测试 。 我们 还 特别 为 测试 目的 而 
准备 了 可 在 test 和 no-discovery 配置 项 下 使 用 的 正确 配置 设置 。 每 个 组 件 测 试 都 将 由 
TestRestTemplate 初始 化 ，TestRestTemplate 将 调用 order-service HTTP 端点 。 可 以 基于 
HTTP 啊 应 或 存储 在 能 入 式 MongoDB 中 的 数据 来 执行 测试 结果 验证 ,以 下 是 order-service 
服务 的 组 件 测试 的 示例 实现 。 

QRUuNnWith (SpringRunner.class,) 

QSspringBootTest (webEnvironment = WebEnvironment .RANDOM PORT) 

QFixMethodorder (MethodSorters.NAME ASCENDING) 


QActivePprofiles({"test", "no-discovery"}) 
public class OrderComponentTest 1 


RAutowired 
TestRestTemplate restTemplate; 
@Autowired 
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OrderRepository orderRepository; 
A 
@Test 
public void testAccept(} | 
Order order = new Order{(null, OrderSstatus.ACCEPTED, 1000, "1, "1™. 
Collections.singletonList("1")); 
order = OrderRepository.save (order)}; 
restTemplate.put("/{id}", null, order.getId()); 
order = orderRepository.findone (order.getlId(})}); 
Assert.assertEquals (OrderStatus .DONE, order.getstatus(})}); 
} 


QTest 

public void testPrepare() 1{ 
Order order = new Order(null, Orderstatus .NEW, 1000, ™1™, ™1™. 

Collections. SingletonList( ly} 

order = restTemplate.postForoObject("/", order, Order.class); 
Assert.assertNotNull (order}); 
Assert.assertEquals (Orderstatus .ACCEPTED, order.getstatus (})); 
Assert.assertEquals (940, order.getPrice()); 


13.5 集成 测试 


在 创建 单元 和 组 件 测试 之 后 ， 我 们 已 经 验证 了 微服 务 中 的 所 有 功能 。 但 是 ， 我 们 仍 
然 需 要 测试 与 其 他 服务 、 外 部 数据 存储 和 绥 存 的 交互 。 在 基于 微服 务 的 架构 集成 中 ， 测 
试 的 处 理 方 式 与 一 体 化 应 用 程序 中 的 处 理 方 式 不 同 。 由 于 内 部 模块 之 间 的 所 有 关系 都 已 
通过 组 件 测试 方法 进行 了 测试 ， 因 而 我 们 仅 需 要 测试 与 外 部 组 件 交 互 的 模块 。 


13.5.1 对 测试 进行 分 类 
在 持续 集成 Continuous Integration，CI) 管道 中 分 离 集成 测试 也 是 有 意义 的 ， 这 样 


外 部 中 断 不 会 阻止 或 破坏 项 目的 构建 .开发 人 员 应 该 考虑 通过 使 用 @Category 对 它们 进行 
注解 来 对 测试 进行 分 类 。 可 以 创建 特别 用 于 集成 测试 的 接口 ， 如 IntegrationTest。 


Public interface lntegrationTest { } 
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然后 ， 可 以 使 用 @Category 注解 在 该 接口 上 标记 测试 。 


QCategory (IntegrationTest.class) 
Pablic Class OrderintegrationTest 二 二 二 上 


最 后 ， 可 以 将 Maven 配置 为 仅 运 行 所 选 类 型 的 测试 ， 如 使 用 maven-failsafe-plugin 。 


<plugin> 
<artifactId>maven-failsafe-plugin</artifactId> 
<dependenclies> 
<dependency> 
<gqrouplId>org.apache.maven.surefire</grouplId> 
<artifactId>surefire-junit47</artifactId> 
</dependency> 
</dependencies> 
<Configuration> 
<groups>pl .piomin.services.order.IntegrationTest</groups> 
</configuration> 
<eEXeECUt1lions> 
<eEXxXECUt1ion> 
<qoals> 
<goal>integration--test</goal> 
</goals> 
<confjguration> 
<1includes> 
<include>**/* .class</include> 
</includes> 
</configuration> 
</execution> 
</executions> 
</plugin> 


13.5.2 ”捕获 HTTP 流量 


分 类 是 在 目 动 化 测试 期 间 处 理 与 外 部 微服 务 通信 问题 的 方法 之 一 。 解 决 该 问题 的 男 
一 种 流行 方法 是 记录 传 出 请 求 和 传 入 啊 应 ， 以 便 将 来 使 用 它们 而 无 须 建立 与 外 部 服务 的 
在 前 面 的 示例 中 ， 我 们 仅 在 模拟 模式 下 使 用 Hoverfly。 但 是 ， 它 也 可 以 在 捕获 模式 
下 运行 ， 这 意味 着 它 将 正 第 地 回 真 实 服务 发 出 请 求 ， 但 是 它们 将 被 Hoverfly 拦截 、 记 录 
并 存储 在 文件 中 。 然 后 ， 可 以 在 模拟 模式 中 使 用 以 JSON 格式 存储 的 已 捕获 流量 的 文件 。 
开发 人 员 可 以 在 JUnit 测试 类 中 创建 Hoverfly 规则 ， 如 果 模 拟 文 件 不 存在 , 则 以 捕获 模式 
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启动 ; 如 果 模 拟 文 件 存在 ， 则 以 模拟 模式 启动 。 它 始终 存储 在 src/test/resources/hoverfly 
目录 中 。 

这 就 是 打破 外 部 服务 依赖 关系 的 简单 方法 。 例 如 ， 如 果 开 发 人 员 知 道 没 有 更 改 ， 则 
无 须 与 实际 服务 进行 交互 。 如 果 要 修改 此 类 服务 ， 则 可 以 删除 JSON 模拟 文件 ， 从 而 切 
换 到 捕获 模式 。 如 果 测 试 失 败 ， 则 意味 着 修改 会 影响 到 服务 ， 开 发 人 员 必 须 在 返回 捕获 
模式 之 前 执行 一 些 修复 。 

以 下 是 位 于 order-service 服务 中 的 集成 测试 示例 。 它 会 添加 一 个 新 账户 , 然后 调用 从 
该 账户 中 提取 资金 的 方法 ,由 于 使 用 了 inCaptureOrSimmlationMode 方法 , 仪 当 account.json 
文件 不 存在 或 开发 人 员 更 改 了 传递 给 测试 中 的 服务 的 输入 数据 时 ， 才 会 调用 实际 服务 。 


QRuNnWith (SspringRunner.class) 
QSspringBootTest 

QActiveProfiles ("dev") 

QCategory (IntegrationTest.class) 
Public class OrderintegrationTest 1 


RAutowired 
AccountClient accountClient: 
QAutowired 


CustomerClient customerClient; 
Autowired 

ProductClient productClient; 
@Autowired 

OrderReposlitory orderReposiltory; 


ClassRule 
Public static HoverflyRule hoverflyRule = 
HoverflyRule.inCaptureOrsimulationMode ("account.Json") .printSsimlationData ();} 


QTest 
public void testaAccount () 1{ 
Account account = accountClient.add (new Account (null, ”123”， 
5000}) 1) 7 
acCCount = accountclient.withdraw (account .GetIQ() ， 0U00) ; 
Assert.notNull (account)}),;} 
Assert.equals (account .getBalance ()}, 4000);，; 
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13.6 契约 测试 


有 一 些 有 趣 的 工具 专门 用 于 契约 测试 。 我 们 将 通过 两 个 最 流行 的 工具 一 一 Pact 和 
Spring Cloud Contract 来 讨论 这 个 概念 。 


13.6.1 使 用 Pact 


如 前 文 所 述 ， 契 约 测 试 的 主要 概念 是 定义 使 用 者 〈Consumer) 和 提供 者 (Provider) 
之 间 的 契约 ， 然 后 针对 每 个 服务 独立 地 进行 验证 。 由 于 创建 和 维护 契约 的 黄 任 主要 在 于 
使 用 者 疹 ， 因 而 这 种 类 型 的 测试 通 利 被 称 为 使 用 者 驱动 的 测试 《Consumer-Driven Test) 。 
在 Pact JVM 中 可 以 清楚 地 看 到 对 使 用 者 和 提供 者 方面 的 划分 。 它 提供 了 两 个 独立 的 库 ， 
第 一 个 以 pact-jvm-consumer 为 前 级 ， 第 二 个 以 pact-jvm-provider 为 前 级 。 当 然 ， 执 约 是 
由 使 用 者 与 提供 者 协商 创建 的 ， 如 图 13.4 所 示 。 


存储 库 
(Pact Broker) 


customer-service 对 照 验证 account-service 


(使 用 者 ) (提供 者 ) 
”创建 


图 13.4” 兆 约 测试 示 章 图 


事实 上 ，Pact 是 一 系列 框架 ， 可 以 为 使 用 者 驱动 的 契 约 测 试 提 供 支 持 。 这 些 实现 可 
用 于 不 同 的 语言 和 框架 。 幸 运 的 是 ，Pact 可 以 与 JUnit 和 Spring Boot 一 起 使 用 。 现 在 可 
以 来 考虑 在 我 们 的 示例 系统 中 实现 的 集成 之 一 , 即 customer-service 服务 和 account-service 
服务 之 间 的 集成 。 名 为 customer-service 服务 的 微服 务 将 使 用 Feign 客户 端 与 account- 
service 服务 进行 通信 。 使 用 者 端的 Feign 客户 定义 事实 上 代表 了 我 们 的 契约 。 
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QFeignClient (name = "account-service") 
Public interface AccountClient 1{ 


GetMapping("/customer/{customerId}") 
List<Account> findByCustomer (QPathVariable ("customerId"™) 
String CUstomerId) : 


} 
1. 使 用 者 站 
要 在 使 用 者 端 启 用 有 具有 JUnit 文 持 的 Pact， 可 以 在 项 目 中 包含 以 下 依赖 项 。 
<dependency> 
<grouplId>au.com.dius</groupId> 
<artifactId>pact—-jvm-consumer—junit 2.12</artifactId> 
<Version>3.5.12</version> 
<scope>test</scope> 
</dependency> 


现在 我 们 唯一 要 做 的 就 是 创建 JUnit 测试 类 。 可 以 通过 使 用 @SpringBootTest 注解 并 
使 用 Spring Runner 运行 它 来 将 其 实现 为 标准 的 Spring Boot 测 试 ,要 成 功 执行 创建 的 测试 ， 
我 们 首先 需要 禁用 发 现 客户 端 ， 并 确保 Ribbon 客户 端 将 与 @Rule PactProviderRuleMk2 所 代 
表 的 account-service 服务 的 桩 通信 。 测试 的 关键 点 是 callAccountClient 方法 ， 该 方法 使 用 
@Pact 进行 注解 并 返回 RequestResponsePact。 它 定义 了 请 求 的 格式 和 啊 应 的 内 容 。 在 测 
试用 例 执 行 期 间 ，Pact 会 日 动 生成 该 定义 的 JSON 表示 ， 它 在 target/pacts/addressClient- 
customerServiceProvider.json 文件 中 可 用 。 最 后 ， 调 用 Feign 客户 端 中 实现 的 方法 ， 并 在 
使 用 @PactVerification 注解 的 测试 方法 中 验证 Pact @Rule 返回 的 啊 应 。 以 下 是 一 个 
customer-service 服务 的 使 用 者 痛 契 约 测试 的 实现 示例 。 

RunwWith (SpringRunner.class) 

QspringBootTest (properties = { 

"account—-service.ribbon.listofSservers: localhost:8092", 
"account-service.ribbon.eureka.enabled: false™, 


"eureka.client.enabled: false"™, 


}) 


public class CustomerConsumerContractTest 1 


&Rule 
public PactProviderRuleMk2 stubProvider = new 
PactProviderRuleMk2?2 ("customerServiceProvider", "localhost"™, 8092, this); 
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@Autowired 
private AccountClient accountClient; 


QPact (state = "list-of-3-accounts", provider = 
"customerServiceProvider", consumer = "accountClient") 

public RequestResponsePact callAccountClient (PactDs1lWithProvider 
builder) 1 

return builder.given( list-~of— 3 accounts”}) .ponRecelivingl( 七 已 SEE 

account—-service") 
.path (" /customer/1") .method ("GET") .willRespondWith () .status (200) 
oagvy ta AT AUOnberv MIN" alanecenx“ 50000713 VAN， 
"nmeryv™ "I24" "palancery™ 5000} TY 王 全 和 下 全 下 人 人 
\"balan ce\™":5000}]", "application/json") .toPact (1) ; 

} 


@Test 

QPactVerification(fragment = "callAccountCclient"™") 

public Vvoid verifyAddressCollectionPact() 1{ 
List<Account> accounts = accountClient.findByCustomer("]"); 
Assert.assertEquals(3, accounts.size (}); 


} 


在 target/pacts 目录 中 生成 的 JSON 测试 结果 文件 必须 在 提供 者 端 可 用 。 最 简单 的 解 
决 方案 假设 它 只 能 使 用 @PactFolder 注解 访问 生成 的 文件 。 当 然 ， 它 要 求 提 供 者 可 以 访问 
target/pacts 目录 。 里 然 它 应 该 可 以 用 于 我 们 的 示例 ， 因 为 它 的 源 代码 存储 在 同一 个 Git 
存储 库 中 ， 但 它 并 不 是 我 们 的 目标 解决 方案 。 壮 运 的 是 ， 我 们 可 以 使 用 Pact Broker 在 网 
络 中 发 布 Pact 测试 结果 。Pact Broker 是 一 个 存储 库 服 务 器 ， 它 可 以 提供 用 于 发 布 和 使 用 
Pact 文件 的 HTTP API。 

开发 人 员 可 以 使 用 Docker 镜像 在 本 地 启动 Pact Broker。 它 需要 Postgres 数据 库 作 为 
后 端 存储 ， 因 而 也 需要 启动 带 Postgres 的 容器 。 以 下 是 所 需 的 Docker 命令 。 

docker run -d --name postgres -p 5432:5432 -e POSTGRES USER=oauth -e 

POSTGRES PASSWORD=oauthl23 -e POSTGRES DB=oauth postgres 

docker run -dd --name pact-broker --link postgres:postgres -e 

PACT BROKER DATABASE USERNRME=oauth -e 

PACT BROKER DATABASE PASSWORD=oauth123 -e 

PACT BROKER DATABASE HOST=postgres -e PACT BROKER DATABASE NAME=oauth -p 

9080:80 dius/pact broker 
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在 Docker 上 运行 Pact Broker 之 后 ,必须 在 那里 发 布 我 们 的 测试 报告 。 可 以 使 用 Maven 
插件 pact-jvm-provider-maven 2.12 轻松 执行 此 操作 。 如 果 运 行 mvn clean install pack:publish 
命令 ， 则 放置 在 /target/pacts 目录 中 的 所 有 文件 都 将 被 发 送 到 代理 的 HTTP API。 


<plugin> 
<grouplId>au.com.dius</groupId> 
<artifactId>pact-jJvm-provider-maven 2.12</artifactId> 
<Version>3.5.12</version> 
<cConfigquration> 

<pactBrokerUrl>http://192.168.99.100:9080</pactBrokerUr1> 

</configuration> 

</plugin> 


可 以 使 用 http:/192.168.99.100:9080 上 提供 的 Web 控制 台 显 示 已 发 布 的 Pact 的 完整 
列表 。 它 还 提供 有 关上 次 验证 日 期 的 信息 以 及 列表 中 每 个 Pact 的 详细 信息 ， 如 图 13.5 所 
示 即 为 其 屏幕 截图 。 


Latest pact Webhook Last 
published status verified 


consumer li Provider | 


accountGlient FuUstomerServiteProvider 1 day ago Create about 1 hour ag6 


accountClient ) der 1 minute ago 


图 13.5 已 发 布 的 Pact 的 完整 列表 

2. 生产 者 端 

假设 使 用 者 创建 了 一 个 Pact 并 将 其 发 布 在 代理 上 ， 则 开发 人 员 可 以 继续 在 提供 者 端 
实现 验证 测试 。 要 在 提供 者 端 启用 具有 JUnit 支持 的 Pact， 可 以 在 项 目 中 包含 pact-jvm- 
provider-junit 依赖 项 。 

还 有 男 一 个 框架 也 可 以 使 用 ， 即 pact-jvm-provider-spring。 该 库 允 许 开 发 人 员 使 用 
Spring 和 JUnit 对 提供 者 运行 契约 测试 。 可 以 在 Maven 的 pom.xml 的 以 下 户 段 中 看 到 所 
再 依赖 项 的 列表 。 

<dependency> 

<grouplId>au.com.dius</grouplId> 
<artifactId>pact—jvm-provider—junit 2.12</artifactId> 


<Version>3.5.12</version> 
<scope>test</scope> 
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</dependency> 

<dependency> 
<qroupId>au.com.dius</grouplId> 
<artifactId>pact—jvm-provider-—spring 2.12</artifactId> 
<version>3.5.12</version> 
<scope>test</scope> 

</dependency> 


由 于 Spring 专用 库 的 存在 ， 开 发 人 员 可 以 使 用 SprineRestPactRunner 而 不 是 默认 的 
PactRunner。 反 过 来 ， 这 也 人 允许 开发 人 员 使 用 Spring 测试 注解 ， 如 @MockBean。 在 下 面 
的 JUnit 测试 中 ， 我 们 模拟 了 AccountRepository bean。 它 将 返回 使 用 者 端 测试 所 需 的 3 
个 对 象 。 测 试 将 自动 启动 Spring Boot 应 用 程序 并 调用 /customer/{customerId} 端 点 。 男 外 
还 有 两 件 重要 的 事情 。 通 过 使 用 @Provider 和 @State 注解 ， 我们 需要 设置 与 @Pact 注解 中 
使 用 者 问 的 测试 设置 相同 的 名 称 。 最 后 ， 通 过 在 测试 类 上 声明 @PactBroker， 可 以 为 Pact 
的 存储 库 提供 连接 设置 。 以 下 是 使 用 Pact 的 测试 示例 ， 它 将 验证 由 customer-service 服务 
上 友 布 的 契约 。 


QRunNnWith (SpringRestPactRunner.class) 

QProvider ("customerServiceProvider") 

QPactBroker (host = "192.168.99.100"™", port = "9080") 
QSspringBootTest (webEnvironment = 
SpringBootTest.WebEnvironment .DEFINED PORT, properties = 1 
"eureka.client.enabled: false"™"™ 用) 

public class AccountProviderContractTest | 


MockBean 

private AccountRepository repository; 

TestTarget 

public final Target target = new HttpTarget (8091); 


QState ("1]ist-of-3-accounts"™) 
Public void toDefaultstate(} 1 
List<Account> accounts = new ArrayList<> () 7 
ccounts.add (new Account ("1™, ™123™, 5000,. ™]1™)}: 
accounts.add (new Account ("2™, ™124™, 5000, "17 ) : 
accounts.add (new Account ("3™, ™125™, 5000,. ™1™))}): 
when (repository.findByCustomerIld("1"))} .thenReturn(accounts}); 
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13.6.2 使 用 Spring Cloud Contract 


Spring Cloud Contract 提供 的 契约 测试 方法 与 Pack 略 有 不 同 。 在 Pack 中 ， 使 用 者 负 
责 发 布 契约 ， 在 Spring Cloud Contract 中 ， 此 操作 的 发 起 者 却 是 提供 者 。 契 约 作为 JAR 
存储 在 Maven 存储 库 中 ， 包 含 基于 契约 定义 文件 自动 生成 的 柱 。 可 以 使 用 Groovy DSL 
语法 创建 这 些 定义 。 它 们 中 的 每 一 个 都 包含 两 个 主要 部 分 : 请求 和 啊 应 规范 。 在 这 些 文 
件 的 基础 上 ，Spring Cloud Contract 生成 JSON 桩 定义 ，WireMock 使 用 它们 在 客户 端 进行 
集成 测试 。 与 Pact〈 用 作文 持 了 REST API 的 使 用 者 驱动 的 契约 测试 的 工具 ) 相 比 ， 它 专门 
用 于 测试 基于 JVM 的 微服 务 。 它 由 以 下 3 个 子 项 目 组 成 。 

JW Spring Cloud Contract Verifier 

UD Spring Cloud Contract Stub Runner 

JU Spring Cloud Contract WireMock 

现在 我 们 不 妨 来 分 析 如 何在 契约 测试 中 使 用 它们 ， 为 方便 起 见 ， 测 试 仍 然 使 用 之 前 
在 第 13.6.1 节 “ 使 用 Pact” 中 描述 的 相同 示例 。 
全 注意 : 

WireMock 是 基于 HTTP 的 API 的 模拟 器 。 有 些 开发 人 员 
工具 或 模拟 服务 器 。 通 过 捕获 流入 和 流出 现 有 API 的 流量 ， 它 

1. 定义 契约 和 生成 桩 

如 前 文 所 述 ， 与 Pact 相反 ， 在 Spring Cloud Contract 中 ， 提 供 者 《服务 器 端 ) 负责 发 
布 契 约 规 范 。 因 此 ， 我 们 将 从 account-service 服务 开始 实现 ， 该 服务 为 customer-service 
服务 调用 的 端点 提供 服务 。 但 在 继续 实现 之 前 ， 请 看 图 13.6 中 的 图 解 ， 它 说 明了 参与 测 
试 过 程 的 主要 组 件 。 

示例 应 用 程序 的 源 代 码 在 与 先前 示例 相同 的 GitHub 存储 库 中 可 用 ， 但 在 不 同 的 
contract 分 文 上 。 

要 为 提供 者 端 应 用 程序 启用 Spring Cloud Contract 功能 ， 首 先 必 须 将 Spring Cloud 
Contract Verifier 包含 在 项 目 依 赖 项 中 。 


<dependency> 


能 会 认为 它 是 服务 虚拟 化 
够 快速 启动 和 运行 。 


可 
能 


<groupId>org.springframework.cloud</grouplId> 
<artifactId>spring-cloud-starter-contract-—verifier</artifactId> 
<scope>test</scope> 

</dependency> 
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stubs.) 
re ar 
(maven) 


customer-service stub contract account-service 


| -| 


(使 用 者 ) | runner verifier (提供 者 ) 


13.6 参与 测试 过 程 的 主要 组 件 


下 一 步 是 添加 Spring Cloud Contract Verifier Maven 插件 ， 该 插件 将 生成 并 运行 契约 
测试 。 它 还 会 在 本 地 Maven 存储 库 中 生成 和 安装 桩 。 它 有 一 个 必须 定义 的 唯一 参数 ， 即 
由 生成 的 测试 类 扩展 的 基 类 所 在 的 包 (Package) 。 


<plugin> 
<OroupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-contract-maven-plugin</artifactId> 
<version>1 .2.0.RELEASE</version> 
<extensijons>true</extensions> 
<Configuration> 

<packageWithRBaseClasses>pl .piomin.services.account</packageWithRBaseClasses> 
</configuration> 

</plugin> 


现在 ， 我 们 必须 为 契约 测试 创建 一 个 基 类 。 候 应 该 放 在 pl.piomin.services.account 包 
中 。 在 下 面 的 基 类 中 ， 将 使 用 @SpringBootTest 设置 Spring Boot 应 用 程序 ， 然 后 模拟 
AccountRepository。 开 发 人 员 还 可 以 使 用 RestAssured 来 模拟 Spring MVC,， 并 仪 同 控制 器 


。 296 。 精通 Spring Cloud 微服 务 架 构 


发 送 请 求 。 由 于 上 述 模拟 的 存在 ， 测 试 不 会 与 任何 外 部 组 件 〈 如 数据 库 或 HTTP 端点 ) 
交互 ， 并 仅 测 试 契约 。 
QRUuNnWith (SpringRunner.class,) 


QSspringBootTest (classes = {AccountApplication.class}) 
Public abstract class AccountProviderTestBase 1 


QAutowired 
private WebApplicationContext context; 
MockBean 
private AccountReposijitory repository; 


Before 

public void setup() { 
RestAssuredMockMvc .webAppContextSetup (context);} 
List<Account> accounts = new ArrayList<> (); 
accounts.add (new Account (- 1- , "123™", S5000, ”1 7; 
accounts.addinew Account (2, “124". 5000,. ™1™)}; 
accounts.add inew Account(™3", “1125 5000,. ™1™). 
when (repository.findByCustomerIld("1")} .thenReturn (accounts})} 


} 

我 们 已 经 提供 了 使 用 Spring Cloud Contract 运行 测试 所 需 的 所 有 配置 和 基 类 。 因 此 ， 
现在 可 以 进入 最 重要 的 部 分 ， 使 用 Spring Cloud Contract Groovy DSL 定义 契约 。 契 约 的 
所 有 规范 都 应 位 于 /src/test/resources/contracts 目录 中 。 此 目录 下 的 特定 位 置 (包含 桩 定义 ) 
将 被 视 为 基本 测试 类 名 。 每 个 桩 定义 代表 单个 契约 测试 。 根 据 此 规则 ，spring-cloud- 
contract-maven-plugin 会 自动 查找 契约 并 将 其 分 配给 基础 测试 类 。 在 目前 讨论 的 示例 中 ， 
我 们 将 桩 定义 放 在 /src/test/resources/contracts/accountService 目录 中 。 因 此 ， 生 成 的 测试 类 
名 称 为 AccountServiceTest， 它 还 扩展 了 AccountServiceBase 类 。 

以 下 是 契约 规范 的 示例 ， 它 返回 属于 客户 的 账户 列表 。 这 份 契约 不 是 很 简单 ， 所 以 
有 些 事情 需要 解释 。 开 发 人 员 可 以 使 用 正则 表达 式 在 Contract DSL 中 编写 请 求 。 还 可 以 
根据 通信 方 〈 使 用 者 或 生产 者 ) 为 每 个 属性 提供 不 同 的 值 。Contract DSL 还 使 开发 人 员 能 
够 使 用 ffomRequest 方法 在 啊 应 中 引用 请 求 。 以 下 契约 将 返回 3 个 账户 的 列表 ， 从 请 求 路 
径 和 id 字段 中 获取 customerld 字段 ， 其 中 包含 $ 个 数字 。 

org.springframework.cloud.contract.spec.Contract .make | 


redgquest | 
method “GET 
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url value (consumer (regex('/customer/[0-9] {3}'})}), producer('/customer/l1")) 


} 
responserN 
status 200 
body (| 


[ 
iqd- sreogqezt [LO S11) 74) 
number: “123", 
balance: 5000, 
customerld: fromRequest () .path (1) 
1 | 
id= lregexz( [0 2115) 71). 
number: “124 ， 
balance: 5000 ， 
customerld: romRedguest () .path (1) 
| 
i wreqexl [0 112) 71). 
number: "125", 
balance: 5000 ， 
customerld: romRedguest () .path (1) 
] 
]) 
headers 1{ 
contentType (applicationJson ()) 
} 
} 
} 


在 Maven 构建 的 测试 阶段 ， 在 target/generated-test-sources 目录 下 将 生成 测试 类 。 以 
下 是 从 上 述 契 约 规范 中 生成 的 类 。 
public class AccountServiceTest extends AccountServiceBase | 


Test 
public void validate customerContract() throws EXCeptlIon 1{ 


// given: 
MockMvycRequestSpecifijcation request = given(}; 


/i when: 
ResponseOptions response = gliven() .spec (regquest) 


Ot tm 
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FF Tthen: 
assertThat (response.statusCode(})} .isEqualTo (200)，; 
assertThat (response.header ("Contento— 

TYPe") ) .matches ("application/json.*"); 


// and: 

DocumentContext parsedJson = 
JsonPath .parse (response.getBody() .asString() ) ; 
assertThatJson (parsedJson) .array(}) .contains("[ number']").isEqualTo( 123 7 
assertThatJson (parsedJson) .array () .contains("[ balance | ) .isEqualTo (23000)，; 
assertThatJson (parsedJson) .array() .contains ("|[ number’']").isEqualTo("124"); 
assertThatJson (parsedJson) .array () .Contalns ( | customeTrId |]").isEqualTo("l1"); 
assertThatJson (parsedJson)}) .array() .COontalns( | 1d ] ) -matches( [0-9] {5}"}; 


} 
} 


2. 验证 使 用 者 方面 的 契约 

假设 我 们 已 经 在 提供 者 端 成 功 构 建 并 运行 了 测试 , 那么 将 生成 桩 , 然后 在 本 地 Maven 
存储 库 中 发 布 。 为 了 能 够 在 使 用 者 应 用 程序 测试 期 间 使 用 它们 ， 应 该 将 Spring Cloud 
Contract Stub Runner 包含 到 项 目 依赖 项 中 。 

<dependency> 

<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-contract-—-stub—runner</artifactId> 
<Scope>test</scope> 

</dependency> 

然后 ， 我 们 应 该 用 @AutoConfigureStubRunner 注解 测试 类 。 它 需要 两 个 输入 参数 一 一 
ids 和 workOffline。ids 字段 是 artifactId4、groupId、 版 本 号 、stubs 限定 符 和 端口 号 的 连接 
产物 ， 并 且 通 常 指向 提供 者 发 布 的 桩 的 JAR。workOffline 标志 指示 具有 桩 的 存储 库 所 在 
的 位 置 。 默 认 情 况 下 ， 使 用 者 将 尝试 从 Nexus 或 Artifactory 自动 下 载 工件 。 如 果 开 发 人 
员 希 望 强制 Spring Cloud Contract Stub Runner 仅 从 本 地 Maven 存储 库 下 载 社 ， 则 可 以 将 
workOffline 参数 的 值 切 换 为 true。 

以 下 是 一 个 JUnit 测试 类 ， 它 使 用 Feign 客户 端 从 提供 者 端 发 布 的 桩 中 调用 端点 。 
Spring Cloud Contract 会 查找 pl.piomin.services:account-service 工件 的 最 新 版 本 ,已经 通过 
在 @AutoConfigureStubRunner 注解 中 将 + 符号 作为 桩 的 版 本 传递 来 表示 。 如 果 开 发 人 员 
想 要 使 用 该 工件 的 具体 版 本 ， 则 可 以 从 pom.xml 文件 而 不 是 使 用 + 符号 来 设置 当前 版 
本 ， 如 @AutoConfigureStubRunner(ids={"pl.piomin.services:account-service:1.0-SNAPSHOT: 
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stubs:8091" })。 


QRunNnWith (SpringRunner.class) 
QSspringBootTest (properties = { 
"eureka.client.enabled: false"™ 


}) 
QAutoCconfigurestubRunnerl(ids = {"pl.piomin.services:account— 
service:+:stubs:8091"™}, workoffline = true) 


public Class AccountContractTest { 


@Autowired 
private AccountClient accountClient; 


QTest 

Public Vold verifyAccounts() 1 
List<Account> accounts = accountClient.findRycCustomer("l1").; 
Assert .assertEgquals(3, accounts.size(}}s 


} 


现在 剩 下 的 唯一 事情 是 使 用 mvn clean install 命令 构建 整个 项 目 ， 以 验证 测试 是 否 成 
功 运 行 。 但 是 ， 开 用 人员 应 该 记 住 的 是 ， 之 前 创建 的 测试 仅 闻 闹 customer-service 服务 和 
account-service 服务 之 间 的 集成 。 在 我 们 的 示例 系统 中 ， 应 该 验证 的 微服 务 之 间 还 有 一 些 
其 他 的 集成 。 我们 将 演示 一 个 测试 整个 系统 的 示例 。 它 将 测试 已 公开 的 order-service 服务 
的 方法 ， 并 且 该 服务 将 与 所 有 其 他 微服 务 进行 通信 。 为 此 ， 我 们 将 使 用 Spring Cloud 
Contract 方案 的 另 一 个 有 趣 功能 。 

3. 方案 

使 用 Spring Cloud Contract 定义 方案 (Scenario〉 并 不 困难 。 唯 一 需要 做 的 就 是 在 创 
建 契 约 时 提供 正确 的 命名 约定 。 此 约定 假定 作为 方案 一 部 分 的 每 个 契约 的 名 称 都 以 订单 
号 和 下 男 线 为 前 缀 。 单 个 方案 中 包含 的 所 有 契约 都 必须 位 于 同一 目录 中 。Spring Cloud 
Contract 方案 基于 WireMock 的 方案 。 以 下 是 一 个 目录 结构 ， 其 中 包含 为 创建 和 接受 订单 
的 方案 需求 定义 的 合约 。 

src\main\resources\contracts 

OrderService\ 


1] createOrder .groovy 
2 acceptorder .groovy 
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以 下 是 为 该 方案 生成 的 测试 的 源 代码 。 


aFIxMethodorader (MethodSorters.NAME ASCENDING) 
Public class OrdersSscenarioTest extends OrderSscenarioBase 1 


Test 

public Void validate 1 createOrder(} throws Exception 1{ 
i 

} 


QTest 

public Vold validate 2 acceptoradezr () throws Exception 1{ 
i 

} 


} 


现在 ， 假 设 我 们 有 很 多 微服 务 ， 并 且 大 多 数 微服 务 与 一 个 或 多 个 其 他 微服 务 进行 通 
信 。 因 此 ， 即 使 测试 单个 契约 ， 也 无 法 确保 在 服务 间 通 信 期 间 所 有 其 他 契约 按 预 期 工作 。 
但 是 ， 使 用 Spring Cloud Contract， 则 可 以 轻松 地 将 所 有 必需 的 桩 包含 在 测试 类 中 ， 这 使 
得 开发 人 员 能 够 验证 已 定义 方案 中 的 所 有 扑 约 。 这 需要 包含 spring-cloud-starter-contract- 
verifier 和 spring-cloud-starter-contract-stub-runner 依赖 项 。 以 下 类 定义 将 充当 Spring Cloud 
Contract 测试 类 的 基础 ， 并 包括 由 其 他 微服 务 生成 的 桩 。 为 order-service 服务 端点 生成 的 
桩 可 以 由 需要 使 用 order-service 服务 验证 契约 的 任何 其 他 外 部 服务 使 用 。 像 以 下 代码 这 样 
的 测试 不 仅 将 验证 此 服务 与 order-service 服务 之 间 的 契约 ， 还 将 验证 order-service 服务 与 
该 服务 使 用 的 其 他 服务 之 间 的 契约 。 


RunwWith (SspringRunner.class) 
QspringBootTest (properties = | 
"eureka.client.enabled: false™" 

}) 

QAutoCconfigureSstubRunner(ids = { 
“PLDIoOMIin.Services:Aaccount service:+t:stubs:8091", 
"Pl .piomin.services:customer—-service:+:stubs:8092", 
"pl .piomin.services:product—service:+:stubs:80903" 

}, workoffline = true)} 

public class OrderScenarioBase | 


@Autowired 
private WebApplicationContext context; 
QMockBean 
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private OrderRepository repository; 
Before 
public Vvoid setup(} 1 
RestAssuredMockMvc .webAppContextSetup (context),; 
when (repository.countByCustomerld (Matchers .anystring'()))}). 
thenReturn (0}); 
when (repository.save (Mockito.any (Order.class}) )) .thenAnswer (new 
Answer<Order>() I 
QOverride 
public Order answer (InvocationOnMock jnvocation) throws 
Throwable 1{ 
Order oo = invocation.getArgumentAt (0, Order.class); 
口 .SetIQL( ”1234252”) : 
return OF 


13.7 性 能 测试 


现在 还 有 最 后 一 种 类 型 的 目 动 化 测试 要 讨论 ， 也 就 是 本 章 开 头 已 经 提 到 过 的 性 能 测 
试 。 有 一 些 非常 有 趣 的 工具 和 框架 可 以 帮助 开发 人 员 创 建 和 运行 此 类 测试 。 

性 能 测试 工具 有 很 多 选择 ， 特 别 是 对 于 HTTP API 测试 来 说 尤其 如 此 。 我 们 无 法 讨 
论 所 有 这 些 工 具 ， 但 介绍 一 个 框架 也 是 很 有 用 的 。 我 们 接 下 来 将 要 讨论 的 框架 就 是 
Gatling。 

Gatling 是 一 个 用 Scala 编写 的 开源 性 能 测试 工具 。 它 允许 开发 人 员 以 易于 阅读 和 写 
入 的 领域 特定 语言 (Domain-Specific Laneuage，DSL) 开发 测试 。 它 通过 生成 全 面 的 图 
形 负载 报告 从 竞争 者 中 脱颖而出 ， 其 报告 说 明了 在 测试 用 例 期 间 收 集 到 的 所 有 指标 。 可 
以 通过 一 些 插件 将 Gatling 与 Gradle、Maven 和 Jenkins 集成 在 一 起 。 

1. 局 用 Gatling 


要 为 项 目 司 用 Gatling 框架 ， 应 该 在 依赖 项 中 包含 io.gatling.highcharts:gatling-charts- 
highcharts 工件 。 


2. 定义 测试 方案 
每 个 Gatling 测试 套件 都 应 该 扩展 Simulation 类 。 在 每 个 测试 类 中 ,可 以 使 用 Gatling 


。302 。 精通 Spring Cloud 微服 务 架 构 


Scala DSL 声明 一 个 方案 列表 。 我 们 通常 声明 可 以 调用 HTTP 端点 的 并 发 线程 数 ， 以 及 每 
个 线程 发 送 的 整体 请 求 数 。 在 Gatling 术语 中 ， 线 程 数 由 使 用 atOnceUsers 方法 设置 的 用 
户 数 决定 。 测 试 类 应 放 在 src/test/scala 目录 中 。 

假设 我 们 要 测试 运行 20 个 客 / ! 端 的 order-service 服务 公开 的 两 个 端点 ， 其 中 每 个 端 
点 按 顺 序 发 送 500 个 请 求 ， 这 意味 着 总 共 会 发 送 20X2X500=20000 个 请 求 。 通 过 在 短 时 
闻 内 发 送 所 有 内 容 ， 开 发 人 员 葡 能够 测试 应 用 程序 的 性 能 。 

以 下 测试 方案 是 用 Scala 编写 的 ， 现 在 我 们 来 仔细 研究 一 下 。 在 运行 此 测试 之 前 ， 我 
们 通过 调用 HTTP API 创建 了 一 些 账 户 和 产品 ， 并 通过 account-service 服务 和 product- 
service 服务 公开 。 由 于 它们 连接 到 外 部 数据 库 ， 因 而 会 目 动 生成 ID。 为 了 提供 一 些 测试 
数据 ， 笔 者 已 将 它们 复制 到 测试 类 中 。 上 有 具有 账户 和 产品 ID 的 列表 都 作为 订阅 源 传递 给 测 
试 方案 。 然 后 ， 在 每 次 迭代 期 间 ， 从 列表 中 随机 选择 所 需 的 值 。 我 们 的 测试 方案 名 为 
AddAndConfirmOrder。 它 由 两 个 exec 方法 组 成 。 第 一 个 是 通过 调用 POST /order HTTP 
方法 创建 一 个 新 订单 。 订 单 的 ID 由 服务 目 动 生成 ， 因 而 应 将 其 保存 为 属性 。 然 后 它 可 以 
在 下 一 个 exec 方法 中 使 用 ， 该 方法 将 通过 调用 PUT /order/{id} 六 点 来 确认 订单 。 在 此 测 
试 之 后 唯一 验证 的 是 HITP 状态 。 


class OrderApiGatlingSimulationTest extends Simulation 1 


val rcCcustomer = Iterator.continually{(Mapl("customer™” -> 
List("Saa8fodeb44f3f188896efS6ef", "vaaBfoyecb44f3f188896fo10"™, 
"baa8f5fbb44f3f188896f571™，, 
"Daa8f620bA44f3f188896f5712™") .1ift (Random.nextInt (4)}) .get)) 

val rProduct = lterator.continually(Map("product™ -> 
List("S5aa8fad2b44f3f18f8856ac9", "5aa8fad8b44f3f18f8856aca"™, 
"Jaa8fadeb44f3f18f8856acb", "5aa8fae3b44f3f18f8856acc”, 
"aa8fae /Jb44f 3f18f8856acd", "JaaB8faedb44f3f18f8856ace”", 
"5aa8faf2b44f3f18f8856acf") .11ft (Random.nextInt())}) .get)) 


Val scn = 
scenario(" "AddAndConfirmOrder") .feed(rCustomer) .feed (rProduct). 
repeat (500, "™n™) { 
EXecl 
httpl(" AddOoOrder-API") 
.Post ("http://localhost:8090/order"™") 
.header ("Content-Type", "application/json") 
.body (StringBody("""{"productIids": ["${product}"],"customerIid":"${custo 
merl}",." status =: NEW" +"™™™")Y) 
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.Check(status.lis(200) ，]jsonpPath (" 3.1q") .saveAs ("OrdeTrIQG") ) 


| 
http( "ConfirmOorder—-API") 
.put ("http://localhost:8090/order/s$s {orderId}") 
.header ("Content-Type", "application/json") 
.Check (status.1s (200}))} 


setUp(scn.inject (atonceUsers (20))) .maxDuration (FiniteDuration. 
apply(l10, "minutes"™))} 


3. 运行 测试 方案 

在 开发 人 员 的 计算 机 上 运行 Gatling 性 能 测试 有 铬 干 种 不 同 的 方法 。 其 中 之 一 是 通过 
Gradle 插件 (Gradle 插件 可 以 为 在 项 目 构建 期 间 运 行 测试 提供 文 持 ) , 也 可 以 使 用 Maven 
插件 或 尝试 从 集成 开发 环境 运行 它 。 如 果 使 用 Gradle 构建 项 目 ， 还 可 以 通过 局 动 
io.gatling.app.Gatling 主 类 来 定义 仅 运 行 测试 的 简单 任务 。 以 下 是 gradle.build 文件 中 此 类 
任务 的 定义 。 


task loadTest (type: JavaExec) 1 
dependsOon testClasses 
description = "Load Test With Gatling™" 
group = "Load Test"™ 
classpath = sourceSets.test.runtimeClasspath 
jvmaArgs = | 
"Dgatliing.core.directory.binaries= 
s{sourceSets.test.output.classesDir.tostri ng(})}" 
] 
maln = "io.gatling.app.Gatling™ 
args = | 
"——similation”., 
“Pl.piomin.services.gatling.o0rderApiGatlingSsimulationTest™ 
"——results-folder™”, "${buildDir}/gatling—results", 
"——binaries-folder”, sourceSets.test.output.classesDir.tostring(), 
“"——-bodies-folder™, 


sourceSets.test.resources.srcDirs.toList()}) .first() .toString() + 


Fr 
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"jgqatling/bodies", 
] 

] 

现在 ， 只 需 调用 gradle loadTest 命令 即 可 运行 该 人 任务。 当然， 在 运行 这 些 测试 之 前 ， 
还 需要 启动 所 有 示例 微服 务 、MongoDB 和 discovery-service 服务 。 默 认 情 况 下 ，Gatling 
将 打印 所 有 发 送 的 请 求 、 接 收 到 的 啊 应 和 最 终 的 测试 结果 ， 包 括 时 间 统 计 信 息 以 及 API 
调用 成 功 或 失败 的 次 数 。 如 果 需 要 更 详细 的 信息 ， 则 应 参考 测试 后 生成 的 文件 ， 这 些 文 
件 位 于 build/gatling-results 目录 下 。 开 发 人 员 可 以 发 现 ， 其 HTML 文件 会 以 图 表 和 图 形 
的 形式 提供 可 视 化 结果 。 首 先 显 示 的 是 一 个 汇总 (如 图 13.7 所 示 ) ， 其 中 包含 生成 的 请 
求 总 数 和 按 百 分 位 数 细 分 的 最 大 啊 应 时 间 。 例 如 ， 在 图 13.7 中 可 以 看 到 ，AddOrder API 
的 95% 吧 应 中 的 最 大 啊 应 时 间 为 835 毫秒 。 


Number of requests 


t < B00 ms B00 ms <t < ts T1200 ms 
1200 ms 


hb STATISTICS Expand all groups | Collapse all groups 
Executions (©) Response Time (ms) 


Requests * 了 本国 了 
Totals | oke | kos | iD。| Resss| wins | 2 | oh | > | So | maxs | Means | so. 
KO pct | pct=# Pet 地 | pet=# Dev * 
Global Information 20000 19999 : 0 ?8.74 179 333 759 1192 2850 247 257 
AddOQOrder-API 10000 10000 0 0 39.37 了 1355 2850 366 267 


ConfirmOrder-API 10000 9999 旺 39.31 与 6 1 10 | 128 180 


13.7 ”Gatling 的 可 视 化 结果 


还 有 一 些 其 他 的 有 趣 统 计数 据 可 视 化 。 如 图 13.8 所 示 的 是 值得 我 们 特别 关注 的 两 个 
报告 。 其 中 第 一 个 报告 的 图 表 显 示 了 按 平 均 啊 应 时 间 分 组 的 请 求 白 分 比 ， 而 第 二 个 报告 
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则 以 百 分 位 数 显 示 了 平均 啊 应 时 间 的 时 间 线 。 


吕 
加 
到 
了 
苹 
号 
= 
9 
a 
区 
il 
5 


Response Time (ms) 


ek 


in 00 mx AllUsers 


图 13.8 ”有 趣 的 统计 数据 可 视 化 结果 
13.8 小 结 


本 章 介 绍 了 一 些 可 以 帮助 开发 人 员 有 效 测 试用 Java 编写 的 基于 REST 的 应 用 程序 的 
框架 。 这 些 解决 方案 中 的 每 一 个 都 已 分 配给 特定 类 型 的 测试 。 我 们 专注 于 讨论 与 微服 务 
严格 相关 的 测试 ， 如 契约 测试 和 组 件 测 试 。 本 章 的 主要 目标 是 比较 用 于 契约 测试 的 两 个 
最 流行 的 框架 ， 即 Pact 和 Spring Cloud Contract。 尽 管 外 表 相 似 ， 但 它们 之 间 存 在 一 些 显 
著 差 异 。 本 章 采 用 了 与 前 几 章 相同 的 示例 应 用 程序 ， 展 示 了 它们 之 间 最 重要 的 相似 点 和 
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不 同 点 。 

微服 务 与 日 动 化 严格 相关 。 开 发 人 员 应 该 意识 到 ， 从 一 体 化 应 用 程序 到 微服 务 的 迁 
移 使 我 们 有 机 会 重 构 代 码 ， 并 且 还 可 以 提高 自动 化 测试 的 质量 和 代码 履 兰 率 。 诸 如 
Mockito 、Spring Test、Spring Cloud Contract 和 Pact 等 框架 在 一 起 使 用 时 ， 可 以 为 开发 人 
员 提 供 一 个 非常 强大 的 解决 方案 ， 开 发 基于 REST 的 Java 微服 务 的 测试 。 目 动 化 测试 是 
持续 集成 /持续 交付 (CLCD) 过 程 的 重要 组 成 部 分 ， 第 14 章 将 详细 讨论 该 过 程 。 


第 三 部 分 


D 
ocker 文 持 和 Spring Cloud 平台 


第 14 草 Docker 支持 


在 本 书 第 一 部 分 (第 1 章 一 第 3 章 ) 中 已 经 讨论 了 微服 务 架 构 和 Spring Cloud 项 目 
的 基础 知识 ; 在 第 二 部 分 〈 第 4 章 一 第 13 章 ) 中 则 研究 了 微服 务 架 构 中 最 剃 见 的 元 素 ， 
并 演示 了 如 何 使 用 Spring Cloud 实现 它们 。 到 目前 为 止 ， 我们 已 经 详细 介绍 了 与 微服 务 
迁移 相关 的 一 些 重要 主题 ， 如 集中 式 日 志 记 录 、 分 布 式 跟踪 、 安 全 性 和 目 动 化 测试 等 。 
在 掌握 了 这 些 知 识 之 后 ， 现 在 我 们 可 以 进入 本 书 的 最 后 一 部 分 内 容 ， 讨 论 人 微服 务 作为 云 
原生 态 开 发 方法 的 真正 威力 。 例 如 ， 能 够 使 用 容器 化 工具 将 应 用 程序 彼此 隔离 ， 在 软件 
交付 过 程 中 实现 持续 部 署 (Continuous Deployment) 以 及 轻松 扩展 应 用 程序 的 能 力 ， 所 有 
这 些 优点 都 有 助 于 微服 务 的 快速 普及 。 

在 前 面 的 章节 中 ， 我 们 使 用 过 Docker 镜像 (Image) 在 本 地 计算 机 上 运行 第 三 方 工 
具 和 解决 方案 。 以 此 为 切入 点 ， 本章 将 介绍 Docker 的 主要 概念 , 如 它 的 基本 命令 和 用 例 。 
此 信息 将 有 助 于 开发 人 员 运 行 前 面 章 节 中 提供 的 示例 。 然 后, 我 们 将 讨论 如 何 使 用 Spring 
Boot 应 用 程序 示例 构建 镜像 ， 以 及 如 何在 本 地 计算 机 上 的 容器 内 运行 它们 。 我 们 将 使 用 
简单 的 Docker 命令 以 及 更 高 级 的 工具 ， 如 Jenkins 服务 器 ( 它 可 以 帮助 开发 人 员 执 行 完 
整 、 持 续 的 交付 ) ， 并 在 组 织 中 启用 持续 集成 (Continuous Integration，CI) 过 程 。 最 后 ， 
我 们 将 介绍 用 于 部 署 、 扩 展 和 管理 容器 化 应 用 程序 目 动 化 的 最 流行 的 工具 之 一 : 
KuUbermmetes。 

我 们 的 所 有 示例 都 将 通过 Minikube 在 单 节点 Kubernetes 集群 上 以 本 地 方式 运行 。 

本 章 将 要 讨论 的 主题 包括 : 

口 最 实用 的 Docker 命令 。 
构建 包含 Spring Boot 微服 务 的 Docker 容 絮 。 
在 Docker 上 运行 Spring Cloud 组 件 。 
使 用 Jenkins 和 Docker 进行 持续 集成 /持续 交付 。 
在 Minikube 上 部 车 和 运行 微服 务 。 


LDO 


14.1 关于 Docker 


Docker 是 一 个 工具 ， 可 以 帮助 开 肥 人 员 使 用 容 需 创建 、 部 普 和 运行 应 用 程序 。 它 的 
设计 旨 在 使 开 友 人 员 和 系统 管理 员 按 照 DevOps 理念 受益 。Docker 通过 解决 与 之 相关 的 
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一 些 重要 问题 , 帮助 改进 软件 交付 流程 。 其 中 一 个 问题 是 不 可 变 交 付 (Immutable Delivery) 
的 想法 , 这 与 人 们 认为 软件 要 “对 我 有 用 ”的 认识 有 关 。 特别 重要 的 是 , 开发 人 员 在 Docker 
中 进行 测试 所 使 用 的 镜像 与 在 生产 模式 中 所 使 用 的 镜像 相同 ， 应 该 看 到 的 唯一 区 别 是 在 
配置 期 间 。 对 于 基于 微服 务 的 系统 ， 以 不 可 变 交 付 模 式 进 行 的 软件 交付 似乎 特别 重要 ， 
因为 有 许多 独立 部 署 的 应 用 程序 。 由 于 Docker 的 存在 ， 开 发 人 员 现 在 可 以 专注 于 编写 代 
码 而 无 顷 担心 目标 操作 系统 〈 应 用 程序 局 动 的 地 方 ) 。 因 此 ， 该 操作 可 以 使 用 相同 的 接 
口 来 部 署 、 局 动 和 维护 所 有 应 用 程序 。 

Docker 越 来 越 受 欢迎 还 有 很 多 其 他 原因 。 毕 竟 ， 容 器 化 理念 在 信息 技术 领域 并 不 是 
什么 新 鲜 事 。Linux 容器 是 在 很 多 年 前 推出 的 ， 目 2008 年 以 来 一 直 是 其 内 核 的 一 部 分 。 
但 是 ，Docker 已 经 引入 了 其 他 技术 所 没有 的 在 干 新 内 容 和 解决 方案 。 

首先 ， 它 提供 了 一 个 简单 的 接口 ， 人 允许 开发 人 员 轻 松 将 应 用 程序 及 其 依赖 项 打包 到 
单个 容器 中 ， 然 后 路 Linux 内 核 的 不 同 版 本 和 实现 运行 它 。 容 露 可 以 在 任何 支持 Docker 
的 服务 器 上 以 本 地 方式 或 远程 运行 ， 每 个 容器 都 可 以 在 几 秒 钟 内 局 动 。 开 有 人员 也 可 以 
轻松 地 在 其 上 运行 每 个 命令 而 无 须 进入 容 右 内 部 。 此 外 ，Docker 镜像 的 共享 和 分 发 机 制 
允许 开发 人 员 提 交 他 们 的 更 改 ， 并 以 与 共享 源 代 码 相 同 的 方式 推送 和 提取 镜像 ， 如 使 用 
Git。 目 前， 几乎 所 有 最 流行 的 软件 工具 都 作为 镜像 在 Docker Hub 上 发 布 ， 其 中 有 一 些 我 
们 已 成 功用 于 运行 示例 应 用 程序 所 需 的 工具 。 

Docker 架构 由 一 些 基本 定义 和 元 系 组 成 ， 最 备 要 的 就 是 容器 (Container) 。 容 器 在 
单个 计算 机 上 运行 ， 并 与 该 计算 机 共享 操作 系统 内 核 。 它 们 包含 在 机 器 代码 上 运行 特定 
软件 所 需 的 一 切 : 运行 时 (Runtime) 、 系 统 工具 、 系 统 库 和 设置 。 容 器 是 根据 Docker 
镜像 中 的 指令 创建 的 。 镜 像 束 像 是 一 种 配方 或 模板 ， 它 定义 了 在 容器 上 安装 和 运行 必要 
软件 的 步 又 。 容 器 也 可 以 与 虚拟 机 进行 比较 ， 因 为 它们 具有 类 似 的 资源 隔离 和 分 配 优势 。 
但 是 ， 它 们 虚拟 化 的 是 操作 系统 而 不 是 硬件 ， 这 使 得 它们 比 虚 拟 机 更 具 可 移植 性 和 效率 。 
图 14.1 说 明了 Docker 容器 和 虚拟 机 之 间 的 架构 差异 。 

所 有 容器 都 在 称 为 Docker 主机 (Docker Host) 的 物理 或 虚拟 机 器 上 启动 。 反 过 来 ， 
Docker 主机 运行 一 个 Docker 守护 程序 (Docker Daemon) ， 它 将 监听 Docker 客户 端 通过 
Docker API 发 送 的 命令 。Docker 客户 端 可 能 是 命令 行 工 具 或 其 他 软件 ， 如 Kinematic。 除 
了 运行 守护 进程 外 ，Docker 主机 还 儿 责 存储 缓存 镜像 和 从 这 些 镜像 创建 的 容器 。 每 个 镜 
像 都 是 从 一 组 图 层 构 建 的 。 每 个 图 层 仪 包含 与 父 图 层 的 增 量 差 异 。 这 样 的 镜像 并 不 小 ， 
所 以 需要 存储 在 别处 ， 这 个 地 方 叫 作 Docker 注册 表 (Docker Registry) 。 开 发 人 员 可 以 
创建 目 己 的 私有 存储 库 ， 也 可 以 使 用 Web 上 提供 的 现 有 公共 存储 库 。 最 受 欢迎 的 存储 库 
是 Docker Hub， 它 包含 几乎 所 有 必需 的 镜像 。 
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容器 虚拟 机 
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底层 硬件 底层 硬件 


图 14.1 Deocker 容器 和 虚拟 机 之 间 的 架构 差异 
14.2 ”安装 Docker 


适用 于 Linux 的 Docker 安装 说 明和 每 个 发 行 版 本 (https://docs.docker.com/install/ 
#supported-platforms 有关。 但 是 ， 有 时 开发 人 员 必 须 在 安装 后 运行 Docker 守护 程序 ， 
可 以 通过 调用 以 下 命令 来 执行 此 操作 。 

dockerd --host=unix:///var/run/docker.sock --host=tcp://0.0.0.0:2375 


本 节 将 重点 介绍 Windows 平台 的 说 明 , 一 般 来 说 , 在 Windows 或 Mac 上 安装 Docker 
社区 版 (Community Edition, CE) 时 , 有 两 个 可 用 选项 。 最 快 最 简单 的 方法 是 使 用 Docker 
for Windows， 它 可 以 在 https://www.docker.com/docker-windows 上 找到 ， 这 是 一 个 原生 
Windows 应 用 程序 ， 它 为 构建 、 交 付 和 运行 容器 化 应 用 程序 提供 了 易于 使 用 的 开 友 环境 。 
这 绝对 是 最 佳 选择 ， 因 为 它 使 用 Windows 原生 的 Hyper-V 虚拟 化 和 网 络 。 但 是 ， 它 也 有 
一 个 缺点 ， 那 就 是 它 仅 适用 于 Microsoft Windows 10 Professional 或 Enterprise 64 位 。 早 期 
版 本 的 Windows 应 使 用 Docker Toolbox， 开 发 人 员 可 以 访问 https://docs.docker.com/ 
toolbox/toolbox install windows/ 地 址 并 下 载 。 该 工具 箱包 括 Docker 平台 、 和 带 Docker 
Machine 的 命令 行 、Docker Compose、Kitematic 和 VirtualBox 等 。 请 注意 ， 开 发 人 员 无 
法 使 用 Docker Toolbox 在 Windows 上 以 原生 方式 运行 Docker Engine, 因为 它 使 用 了 特定 
于 Linux 的 内 核 功能 。 相反 ， 开 发 人 员 必 须 使 用 Docker Machine 命令 (docker-machine ) ， 
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该 命令 将 在 本 地 计算 机 上 创建 Linux 虚拟 机 并 使 用 Virtual Box 运行 它 。 开 发 人 员 的 计算 
机 可 以 使 用 虚拟 地 址 (默认 情况 下 为 192.168.99.100) 访问 此 虚拟 机 。 之 前 讨论 的 所 有 示 
例 都 与 该 卫 地 址 提供 的 Docker 工具 集成 在 一 起 。 


14.3 第 用 的 Docker 命令 


在 Windows 上 安装 Docker Toolbox 后 ,开发 人 员 应 该 运行 Docker Quickstart Terminal。 
它 可 以 完成 所 需 的 一 切 ， 包 括 创 建 和 局 动 Docker Machine 以 及 提供 命令 行 界面 。 如 果 输 
入 没有 任何 参数 的 Docker 命令 ， 则 现在 应 该 能 够 看 到 包含 说 明 的 可 用 Docker 客户 端 命 
令 的 完整 列表 。 以 下 是 我 们 将 要 看 到 的 命令 类 型 。 

口 运行 和 停止 容器 
列 出 并 删除 容器 
提取 和 推送 镜像 
构建 镜像 
创建 网 络 


_— UDG 


14.3.1 运行 和 俘 止 容 希 

在 安装 Docker 之 后 ， 运 行 的 第 一 个 Docker 命令 通 弟 是 docker run。 如 前 文 所 述 ， 此 
命令 是 以 前 示例 中 最 常用 的 命令 之 一 。 此 命令 执行 两 项 操作 : 它 从 注册 表 中 提取 并 下 载 
镜像 定义 〈 以 防 它 未 在 本 地 缓存 ) ， 并 局 动容 器 。 可 以 为 此 命令 设 兽 许多 选项 ， 要 了 解 
这 些 选 项 ， 可 以 运行 docker run --help 命令 并 进行 查看 。 某 些 选项 具有 单字 母 快 捷 键 ， 这 
通常 是 最 第 用 的 选项 例如 , 选项 -d 可 以 在 后 台 运 行 一 个 容器 ,而 选项 -i 则 可 以 保持 stdin 
打开 ， 即 使 它 没 有 附加 。 如 果 容 器 必须 对 外 公开 任何 端口 ， 则 可 以 使 用 激活 选项 -p 和 定 
义 <port_outside container>:<port inside container>。 某 些 镜 像 需要 其 他 配置 ， 这 些 配 置 一 
般 来 说 可 以 通过 使 用 -e 选项 覆盖 的 环境 变量 来 完成 。 使 用 --name 选项 可 以 为 容器 设置 友 
好 名 称 ， 这 通常 也 很 有 用 ， 它 可 以 为 在 其 上 运行 其 他 命令 提供 方便 。 

在 以 下 Docker 命令 示例 中 ， 启 动 了 包含 Postgres 数据 库 的 容器 ， 并 且 创 建 了 带 密码 
的 数据 库 用 户 ， 然 后 将 和 它 公 开 在 端口 55432 上。 现在， 该 Postgres 数据 库 的 地 址 为 
192.168.99.100:33432。 


$ docker Fun -d --name pg -ee POSTGRES PASSWORD=123456 -e 
POSTGRES USER=plomin -ee POSTGRES DB=example -p 55432:5432 postgres 
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市 Postgres 数据 库 的 容器 可 以 持久 保存 数据 。 对 于 存储 数据 的 容器 来 说 ， 外 部 应 用 
程序 如 果 要 访问 其 数据 ， 推 荐 机 制 是 通过 卷 (Volume) 。 可 以 使 用 -v 选项 将 卷 传递 给 容 
器 ， 其 中 的 值 可 以 由 冒号 〈:) 分 隔 的 字段 组 成 。 第 一 个 字段 是 卷 的 名 称 ， 而 第 二 个 字段 
则 是 路 径 ， 即 该 文件 或 目录 在 容器 中 安装 的 位 置 。 下 一 个 有 趣 的 选项 是 使 用 -m 选项 限制 
为 容器 分 配 的 最 大 RAM 的 能 力 , 以 下 是 创建 新 卷 并 将 其 装 入 已 启动 容器 的 命令 .最 大 RAM 
容量 设置 为 500MB。 在 停止 使 用 激活 的 选项 --rm 之 后 ， 容 器 会 自动 删除 ， 如 下 所 示 。 


$ docker volume create pgdata 
$ docker run --rm -it -e -m 500M -Vv pgdata:/var/lib/postgresql/data -p 
55432:5432 postares 


可 以 使 用 docker stop 命令 停止 每 一 个 正在 运行 的 容器 。 我 们 已 经 为 容器 设置 了 一 个 
名 称 ， 因 而 可 以 轻松 地 将 其 用 作 标 签 ， 如 下 所 示 。 


$ docker stop pg 


由 于 容器 的 整个 状态 被 写 入 磁盘 ， 因 而 开发 人 员 可 以 使 用 与 停止 之 前 完全 相同 的 数 
据 集 再 次 运行 它 ， 如 下 所 示 。 


$ docker start pg 


如 果 只 想 重 新 局 动容 器 ， 则 可 以 使 用 以 下 命令 而 不 是 停止 /局 动容 项 。 


$ docker restart pg 


14.3.2 ” 列 出 并 删除 容器 


如 果 已 经 局 动 茶 些 容器 ， 则 可 能 需要 考虑 在 Docker 计算 机 上 显示 所 有 正在 运行 的 容 
船 列 表 ， 此 时 应 该 使 用 docker ps 命令 ， 如 图 14.2 所 示 。 此 命令 将 显示 有 关 容 器 的 一 些 基 
本 信息 ， 如 会 开端 口 列 表 和 源 镜 像 的 名 称 。 此 命令 仅 打 印 当前 局 动 的 容器 。 如 果 和 硕 望 得 
看 已 停止 或 处 于 非 活 动 状态 的 容 右 ， 则 可 以 在 Docker 命令 中 使 用 选项 -a。 


Co eh CRERTED 3THTUS PORTS 
卫生 ‘sbinAtini ” dus go ; 日 ,外 .和 .所 88- EL 5 /te cP, B.A.B.0:38060- HB tep jenkins 
a tr 


， 则 BB 站 写本 
6 ee Rte yo nt Fa 3 hs , 和 所 站 在 站 站 村 各 生日. 自 : 2->5432 tep 


图 14.2 使 用 docker ps 命令 


如 果 不 再 需要 容器 ， 则 可 以 使 用 docker rm 命令 将 其 删除 。 有 时 需要 删除 正在 运行 的 
容器 ， 默 认 情 况 下 不 允许 这 样 做 。 要 强制 使 用 此 选项 de 
选项 ， 如 下 所 示 。 


$ docker rm -f pg 
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开发 人 员 应 该 记 住 ，docker ps 命令 仅 删除 容器 。 so 的 镜像 仍然 在 本 地 缓存 。 这 
样 的 镜像 可 能 占用 大 量 空间 ， 范 围 从 数 兆 字 节 到 几 百 兆 字 节 。 可 以 使 用 docker rmi 命令 
删除 每 个 镜像 ， 并 将 镜像 ID 或 名 称 作 为 参数 ， Io 


$ docker rmi 875263695ab8 


虽然 我 们 还 没有 创建 任何 Docker 镜像 ， 但 在 镜像 创建 过 程 中 生成 大 量 不 需要 的 或 未 
命名 的 镜像 并 不 罕见 。 这 些 镜 像 可 以 很 容易 识别 ， 因 为 它们 会 使 用 名 称 <none> 表 示 。 在 
Docker 术语 中 ， 这 些 被 称 为 悬空 镜像 /无 效 镜像 (Dangling Image) ， 可 以 使 用 以 下 命令 轻 
检 删 除 。 此 外 ， 还 可 以 使 用 docker imasges 命令 显示 所 有 当前 缓存 镜像 的 列表 ， 如 下 所 示 。 


$ docker rmi $(docker images -dq -f dangling=true) 


14.3.3 ”提取 和 推送 镜像 


我 们 已 经 讨论 过 Docker Hub， 它 是 目前 网 上 最 大 、 最 受 欢 迎 的 Docker 存储 库 。 
以 在 https://hub.docker.com 上 找到 。 _ 冉 认 本 况 下 ，Docker 客户 端 将 妆 试 提取 该 存储 库 和 
所 有 和 镜像。 有 许多 经 过 认证 的 官方 镜像 可 用 于 常见 软件 , 如 Redis、Java、Nginx 或 Mongo， 
但 开发 人 员 也 可 以 找到 其 他 人 创建 的 数 十 万 个 镜像 。 如 有 果 使 用 命令 docker run， 则 会 从 存 
储 库 中 提取 镜像 ， 以 防 它 未 在 本 地 缓存。 还 可 以 运行 以 下 命令 docker pull， 它 仅 负 责 下 载 
镜像 。 


$ docker pull Postgres 


上 述 命令 将 下 载 最 新 版 本 的 镜像 〈 使 用 最 新 标记 的 名 称 ) 。 如 果 开 有 友人 员 想 使 用 旧 
版 本 的 Postgres Docker 镜像 ， 则 应 附加 县 有 特定 版 本 号 的 标签 。 可 用 版 本 的 完整 列表 通常 
发 布 在 镜像 的 站 点 上 , 在 以 下 示例 中 则 没有 区 别 。 开发 人 员 可 以 访问 https://hub.docker.cony 
r/library/posteres/tags/ 以 获取 可 用 标签 的 列表 。 

$ docker pull postgres:9.3 

运行 并 验证 镜像 后 ， 开 发 人 员 应 该 考虑 远程 保存 它 。 最 适合 它 的 地 方 当 然 是 Docker 
Hub。 但是， 有 了 时 开发 人 员 可 外 g 希 望 将 镜像 存储 在 备用 存 侍 (如 私有 存储 库 ) 中 。 在 推送 
镜像 之 前 ， 必 须 使 用 注册 表 用 户 名 、 和 镜像 名 称 及 其 版 本 号 对 其 进行 标记 。 以 下 命令 将 从 
Postgres 源 镜像 创建 一 个 名 为 i 和 1.0 版 本 标记 的 新 镜像 。 

$ docker tag postgres piomin/postgres:1.0 

现在 ， 如 果 运 行 docker images 命令 ， 则 将 看 到 两 个 具有 相同 ID 的 镜像 。 第 一 个 名 
称 为 Postgres， 且 有 最 新 的 标签 ; 第 二 个 名 称 为 piomin/postgres， 标 签 为 1.0。 重 要 的 是 ， 
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piomin 是 笔者 在 Docker Hub 上 的 用 户 名 。 所 以 ， 在 继续 任何 其 他 操作 之 前 ， 我 们 应 该 先 
在 那里 注册 镜像 。 

之 后 ， 我 们 还 应 该 使 用 docker login 命令 登录 我 们 的 Docker 客户 问 。 在 这 里 ， 系 统 
将 提示 输入 用 于 注册 的 用 户 名 、 密 码 和 电子 邮件 地 址 。 最 后 ， 可 以 使 用 以 下 docker push 
命令 推送 带 标 记 的 镜像 。 


$ docker push piomin/postgres:1.0 


现在 剩 下 要 做 的 就 是 使 用 Web 浏览 器 登录 开发 人 员 目 己 的 Docker Hub 账户 ,检查 推 
送 的 镜像 是 否 已 经 出 现 。 如 果 一 切 上 正常， 将 看 到 一 个 新 的 公共 存储 库 ， 其 中 包含 开发 人 
员 自 己 的 镜像 。 图 14.3 显示 了 当前 推送 到 Docker Hub 账户 的 镜像 。 


PUBLIG REPQSITORY 


Short Description | Docker Pyull Gormrmand 


Short description is empty for this repe. docker pull picmin/postgres 


Fuyll Descnption | Dwmer 


Full description is empty for this repo. piomin 


图 14.3 推送 到 Docker Hub 账户 的 镜像 


14.3.4 构建 镜像 


在 14.3.3 节 中 ， 我 们 将 Postgres Docker 镜像 的 副本 推送 到 Docker Hub 注册 表 。 一 般 
来 说 , 我 们 推送 的 是 从 Dockerfile 文件 创建 的 自己 的 镜像 , 该 文件 定义 了 在 容器 上 安装 和 
配置 软件 时 所 需 的 所 有 指令 。 有 关 Dockerfile 结构 的 细节 将 在 后 面 讨论 。 目前 重要 的 是 用 
于 构建 Docker 镜像 的 命令 : docker build。 此 命令 应 在 Dockerfile 所 在 的 同一 目录 中 运行 。 
构建 新 镜像 时 ， 建 议 使 用 -t 选项 设置 其 名 称 和 标记 。 以 下 命令 将 创建 镜像 piomin/order- 
service， 标 记 为 1.0 版 本 。 该 镜像 可 能 会 像 上 一 个 包含 Postgres 的 镜像 一 样 被 推送 到 开发 
人 员 的 Docker Hub 账户 ， 如 下 所 示 。 


$ docker build -t piomin/order-service:1.0 
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14.3.5 创建 网 络 


创建 网 络 是 Docker 架构 的 一 个 重要 方面 ， 因 为 开发 人 员 经 常 要 在 不 同 容 器 上 运行 的 
应 用 程序 之 则 提供 通信 。 和 常见 用 例 是 需要 访问 数据 库 的 Web 应 用 程序 。 我 们 现在 将 参考 
本 书 第 11 章 “ 消 息 驱 动 的 微服 务 ” 中 已 经 介绍 的 另 一 个 示例 。 它 是 Apache Kafka 和 
ZooKeeper 之 间 的 通信 。Kafka 需要 ZooKeeper， 因 为 它 将 各 种 配置 存储 为 ZK 数据 树 中 
的 键 / 值 对 ， 并 在 整个 集群 中 使 用 它 。 如 前 文 所 述 ， 开 发 人 员 首 先 必须 创建 一 个 自 定义 网 
络 并 在 那里 运行 这 两 个 容器 。 以 下 命令 可 用 于 在 Docker 主机 上 创建 用 户 定 义 的 网 络 。 


$s docker network create kafka-network 


在 上 述 命令 运行 完毕 之 后 ， 可 以 使 用 以 下 命令 检查 可 用 网 络 列表 。 默认 情况 下 ， 
Docker 会 创建 3 个 网 络 ， 因 而 开发 人 员 应 该 看 到 4 个 网 络 ， 其 名 称 分 别 为 bridge、host、 
none 和 kafka-netwoIk。 


$s docker network ls 


下 一 步 是 将 网 络 名 称 传递 给 使 用 docker run 命令 创建 的 容器 。 它 可 以 通过 --network 
参数 实现 ， 如 下 例 所 示 。 如 果 为 两 个 不 同 的 容 孝 设置 相同 的 网 络 名 称 ， 那 么 它们 将 在 同 
一 网 络 上 局 动 。 现 在 来 分 析 一 下 这 在 实践 中 意味 着 什么 。 如 果 在 一 个 容器 中 ， 那 么 开发 
人 员 可 以 通过 其 名 称 而 不 是 使 用 其 IP 地 址 调用 它 , 这 融 是 为 什么 在 使 用 Apache Kafka 局 
动容 器 时 可 以 将 环境 变量 ZOOKEEPER 也 设置 为 ZooKeeper。 在 此 容器 内 启动 的 Kafka 
将 连接 默认 端口 上 的 ZooKeeper 实例 ， 如 下 所 示 。 

$ docker run -d --name zookeeper --network kafka-net zookeeper:3.4 


$$ docker un -d --name kafka --network kafka-net -e 
ZOO0KEEPER IP=zookeeper ches/kafka 


14.4 创建 具有 微服 务 的 Docker 镜像 


前 文 已 经 讨论 了 可 用 于 运行 、 创 建 和 管理 容器 的 基本 Docker 命令 。 现 在 是 时 候 创 建 
和 构建 我 们 的 第 一 个 Docker 镜像 ， 以 启动 我 们 在 第 13 章 中 介绍 的 示例 微服 务 。 为 此 ， 开 
发 人 员 应 该 回 到 地 址 https://github.conypiomin/sample-spring-cloud-comm.git 上 的 存储 库 , 然 
后 切换 到 feign with discovery 分 文 (https:/Wsgithub.compiomin/sample-spring-cloud-commny 
tree/feign with discovery) 。 在 该 地 址 上 ， 开 发 人 员 将 找到 每 个 微服 务 、 网 天 和 发 现 的 
Dockerfile。 
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在 讨论 这 些 示例 之 前 ， 开 发 人 员 应 该 参考 Dockerfile 的 一 些 资料 来 理解 其 基本 命令 。 
实际 上 ，Dockerfile 并 不 是 构建 Docker 镜像 的 唯一 方法 ， 在 第 14.4.3 节 中 还 将 演示 如 何 
使 用 Maven 插件 创建 具有 微服 务 的 镜像 。 


14.4.1 


Dockertile 


Docker 可 以 通过 读 取 Dockerfile 中 提供 的 指令 目 动 构建 镜像 , Dockerfile 是 一 个 文档 ， 
其 中 包含 在 命令 行 上 调用 以 组 成 镜像 的 所 有 命令 。 所 有 这 些 命令 都 必须 以 Dockerfile 规范 
中 定义 的 关键 字 开 头 。 以 下 是 最 常用 指令 的 列表 , 它们 按照 在 Dockerfile 中 找到 它们 的 顺 
序 执行 。 在 表 14.1 中 ， 我 们 还 可 以 附加 一 些 注 释 ， 这 些 注 释 的 后 面 必须 跟着 # 字 符 。 


表 14.1 Dockerfile 指令 


指 令 说 明 

这 将 初始 化 一 个 新 的 构建 阶段 ， 并 为 后 续 指 令 设 置 基本 镜像 。 实 际 上 ， 每 个 有 效 的 
Dockerfile 都 必须 以 FROM 指令 开头 
设置 生成 镜像 的 作者 身份 。 该 指令 已 经 建议 不 再 使 用 ， 因 而 仅 可 在 一 些 较 旧 的 镜像 

MAINTAINER | 中 发 现 它 。 开 发 人 员 应 该 使 用 LABEL 指令 而 不 是 MAINTAINER, 如 下 所 示 : LABEL 
maintainer 三 "plotr.Imninkowskaamallconl' 

执行 Linux 命令 ， 在 当前 镜像 之 上 的 新 层 中 配置 和 安装 所 需 软件 ， 然 后 提交 结果 。 
它 可 以 有 两 种 形式 : RUN <command> 或 RUN ["executable","param1"."param2"] 
这 将 配置 一 个 最 终 脚本 ， 在 引导 容器 时 ， 它 将 作为 可 执行 文件 运行 。 它 顽 盖 了 使 用 
CMD 指定 的 所 有 元 素 ， 并 有 两 种 形式 : ENTRYPOINT ["executable","param1", 

ENTRYPOINT 
"param2"] 和 ENTRYPOINT 命令 paraml param2。 值 得 注意 的 是 ， 只 有 Dockerfile 
中 的 最 后 一 个 ENTRYPOINT 指令 才 会 产生 影响 

ee Dockerfile 只 能 包含 一 条 CMD 指令 。 这 条 指令 将 使 用 JSON 数组 格式 为 
ENTRYPOINT 提供 默认 参数 

ENV 这 以 键 / 值 的 形式 设置 容器 的 环境 变量 

将 新 文件 或 目录 从 给 定 源 路 径 复 制 到 由 目标 路 径 定 义 的 路 径 中 容器 内 的 文件 系统 。 

它 具 有 以 下 形式 : COPY[--chown=<user>:<group>] <src>...<DEST> 
这 是 COPY 指令 的 替代 方案 。 它 允许 比 COPY 多 一 点 功能 ， 例 如 ， 它 允许 <src> 成 

ADD | 
为 URL 地 址 

WORKDIR 这 可 以 为 RUN、CMD、ENTRYPOINT、COPY 和 ADD 设置 工作 目录 

i 这 负责 通知 Docker 容 堪 在 运行 时 侦 听 指定 的 网 络 端口 。 和 它 实 际 上 并 不 发 布 端口 。 
端口 将 通过 docker run 命令 上 的 -p 选项 发 布 

VOLUME 这 将 创建 具有 指定 名 称 的 安装 点 。 卷 是 在 Docker 容器 中 持久 保存 数据 的 首选 机 制 

USER 设置 运行 镜像 及 RUN、CMD 和 ENTRYPOINT 指令 时 使 用 的 用 户 名 和 用 户 组 (可 选 ) 


eo 


现在 来 看 一 看 它 在 实践 中 是 如 何 运 作 的 。 我 们 应 该 为 每 个 微服 务 定义 一 个 Dockerfile， 
并 将 其 放 在 Git 项 目的 根 目 录 中 。 以 下 是 为 account-service 服务 创建 的 Dockerfile。 
FROM openjdk:8ul151-—-Jdk-slim-—stretch 
MAINTAINER Piotr Minkowski <piotr.minkowskilamail .com> 
ENV SPRING PROFILES ACTIVE zonel 
ENV EURERKA DEFAULT ZONE http://localhost:876l1/eureka/ 
ADD targety/yaccount-service-1.0-SNAPSHOT.]jar app.Jjar 
ENTRYPOINT [java", "-Xmnxl160m”"， "-]ar”， 
"-Dspring-.profliles.active=5{SPRING PROFILES ACTIVE}", 
"Deureka.client.serviceUrl.defaultzone=$ {EURERA DEFAULT ZONE}", 
"/app.jar"] 
EXPOSE 8091 
前 面 的 例子 并 不 复杂 。 它 只 将 由 微服 务 生成 的 胖 JAR 文件 添加 到 Docker 容器 中 ,并 
使 用 java -jar 命令 作为 ENTRYPOINT。 为 了 更 好 地 理解 它 ， 下 文 将 逐步 进行 分 析 。 我 们 
的 示例 Dockerfile 将 执行 以 下 指令 。 
口 “该 镜像 扩展 了 现 有 的 OpenJDK 镜像 ， 该 镜像 是 Java 平台 标准 版 (Java Platform 
Standard Edition) 的 官方 开源 实现 。OpenJDK 镜像 有 很 多 种 ， 可 用 镜像 变 体 之 
间 的 主要 区 别 在 于 它们 的 大 小 。 标 记 为 8u151-jdk-slim-stretch 的 镜像 提供 了 JDK 
8， 并 包含 运行 Spring Boot 微服 务 所 需 的 所 有 库 。 它 也 比 84151-jdk 版 本 Java 
的 基本 镜像 小 得 多 。 
口 在 这 里 ,我 们 使 用 docker run 命令 的 -e 选 项 定义 了 两 个 可 以 在 运行 时 覆盖 的 环境 
变量 。 第 一 个 是 活动 的 Spring 配置 文件 名 称 ， 默 认 情 况 下 它 将 使 用 zonel 值 初 
始 化 。 第 二 个 是 发 现 服务 器 的 地 址 ， 默 认 情 况 下 等 于 http://localhost:8761/ 
eureka/。 
口 ” 胖 JAR 文件 包含 有 所 有 必需 的 依赖 项 以 及 应 用 程序 的 二 进 制 文件 。 因 此 ， 我 们 必 
须 使 用 ADD 指令 将 已 生成 的 JAR 文件 放 入 容 右 中 。 
口 “我们 将 容器 配置 为 可 执行 Java 应 用 程序 。 定 义 的 ENTRYPOINT 相当 于 在 本 地 
计算 机 上 运行 以 下 命令 。 


Java -Xmxl160m -Jar -Dspring.profiles.actijve = zonel - 
Deureka.client.serviceUrl.defaultzZzone = http: //localhost: 8761/eurekay/ 
app .Jar 


口 ”使 用 EXPOSE 指令 ， 我 们 告知 Docker 它 可 能 会 公开 应 用 程序 的 HITP API， 庐 
APTI 在 端口 8091 上 的 容器 内 可 用 。 
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14.4.2 ”运行 容器 化 微服 务 


假设 我 们 为 每 个 服务 准备 了 一 个 有 效 的 Dockerfile， 下 一 步 是 使 用 mvn clean install 
命令 构建 整个 Maven 项 目 ， 然 后 为 每 个 服务 构建 一 个 Docker 镜像 。 

构建 Docker 镜像 时 ， 应 始终 位 于 每 个 微服 务 源 代码 的 root 目录 中 。 在 基于 微服 务 的 
系统 中 运行 的 第 一 个 容器 必须 是 发 现 服务 器 。 其 Docker 镜像 已 被 命名 为 piomin/discovery- 
service。 在 运行 Docker 的 build 命令 之 前 ， 应 转 到 模块 discovery-service。 这 个 Dockerfile 
比 其 他 微服 务 稍微 简单 一 些 ， 因 为 在 容 右 内 没有 设置 环境 变量 ， 如 下 所 示 。 


FROM openjdk:8u151-—dk—slim-—stretch 

MAINTAINER Piotr Minkowski <piotr.minkowskil@aqmail .Com> 
ADD target/discovery-service—-l1.0-SNAPSHOT.Jjar app.Jjar 
ENTRYPOINT [java, "XmxlAdm™”, "ar", "/app. ar™] 
EXPOSE 8/61 


这 里 仅 执行 5 个 步骤 ， 可 以 在 运行 docker build 命令 之 后 在 目标 镜像 构建 期 间 生 成 的 
| 志 中 看 到 这 些 步 又 。 如 果 一 切 正 第 ， 开 发 人 员 应 访 看 到 在 Dockerfile 中 定义 的 所 有 5 
个 步骤 的 进度 以 及 以 下 最 终 消 息 ， 这 些 消 息 告 诉 开 发 人 员 镜 像 己 成 功 构 建 和 标记 。 


$ docker builda -t piomin/discovery-service:1.0 

Sending build context to Docker daemon 39.9MB 

step 1/5 : FROM openjdk:8ul1l51-jJdk-slim-stretch 
8u1l51-Jdk-slim-stretch: Pulling from library/openjdk 
8176e34d5d92: Pull complete 

2208661344b7: Pull complete 

99f28966f0b2: Pull complete 

e991b55a8065: Pull complete 

aee568884a84: Pull complete 

18be6eb371c215: Pull complete 

Digest: 
sha256:bd394fdc76e8aal73adba2a71547fcb6é6cde3281f70d6b3cae6fa62eflfbde327e3 
Status: Downloaded newer limage for openJdk:8ul51-Jdk-slim-stretch 
---> 52de5d98a41dq 

step 2/5 : MAINTAINER Piotr Minkowski <Piotr .minkowskiegdmnail .com> 
-一 -> Running In ‘8fci8cc21f0 

-一 -> 0ebay7ya369e43 

Removing intermediate container /bftc78cc21t0 

Step 3/5 : ADD target/discovery-service-1.0-SNAPSHOT.JjJar app.jJar 
-一 -> lc6aze04c4dc 

Removing intermediate container 98138425b5a0 
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Step 4/5 : ENTRYPOINT JjJava -Xmxl1l44m -jar /app.JjJar 
-一 -> Running in 7369ba693689 
-一 -> C246470366e4d 
Removing intermediate container /7369ba693689 
Step 5/5 : EXPOSE 8761 
-一 -> Running In i74493ae54220 
-一 -> 06af6a3c2d41 
Removing intermediate container /4493ae54220 
Successfully built O06aféa3c2d41 
Successfully tagged piomin/discovery-service:1.0 


如 果 成 功 构建 了 一 个 镜像 ， 则 应 该 运行 它 。 我 们 建议 创建 一 个 网 络 ， 其 中 将 启动 包 
Ee 要 在 新 创建 的 网 络 中 局 动容 右 ， 必 须 使 用 --network ee 
传递 给 docker run 命令 。 要 检查 容器 是 否 已 成 功 局 动 ， 可 以 运行 docker logs 命令 。 此 命 
令 将 应 用 程序 记录 的 所 有 行 打 印 到 控制 台 ， 如 下 所 示 。 

$ docker network create sample-spring-cloud-network 

$ docker run -d --name discovery -p 8761:8761 --network sample-spring- 

cloud-network piomin/discovery-service:1.0 


dezfac6i13806el34faedee3c0addaa31f2bbadcffbdffA42as3f8eAee44ca0674 
$ docker logs -f discovery 


下 一 步 是 使 用 我 们 的 4 个 微服 务 一 一 account-service 服务 、customer-service 服务 、 
order-service 服务 和 product-service 服务 来 构建 和 运行 容器 ,每 个 服务 的 过 程 都 是 相同 的 。 
例如 ， 如 果 想 要 构建 account-service 服务 ， 则 首先 需要 转 到 示例 项 目 源 代 码 的 该 目录 中 。 
这 里 的 build 命令 与 发 现 服务 的 命令 相同 ,唯一 的 区 别 在 于 镜像 名 称 , 如 下 面 的 代码 段 所 示 。 


$ docker build -t piomin/account-service:1.0 


运行 Docker 镜像 的 命令 对 于 discovery-service 来 说 有 点 复杂 。 在 这 种 情况 下 ， 必 须 
将 Eureka 服务 喜 的 地 址 传递 给 起 始 容器 .由 于 此 容器 与 发 现 服务 容 器 在 同一 网 络 中 运行 ， 
因此 ， 开 发 人 员 可 以 使 用 其 名 称 而 不 是 其 IP 地 址 或 任何 其 他 标识 符 。 或 者 ， 也 可 以 使 用 
m 参数 设置 容器 的 内 存 限制 ， 如 设置 为 256MB。 最后， 还 可 以 使 用 docker logs 命令 查看 
运行 在 容器 上 的 应 用 程序 生成 的 日 志 ， 如 下 所 示 。 
$ docker run -d --name account -p 8091:8091 -e 
EUREKA DEFAULT ZONE=http://discovery:8761/eureka -了 256M --network 


sample-spring-cloud-network piomin/account-service:1.0 
$ docker logs -上 account 


对 于 所 有 其 他 微服 务 ， 应 该 重复 与 前 面 描述 相同 的 步 又。 最 终结 果 是 $ 个 正在 运行 
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的 容器 ， 这 可 以 使 用 docker ps 命令 显示 ， 如 图 14.4 所 示 


图 14.4 使 用 docker ps 命令 显示 的 5 个 正在 运行 的 容器 


所 有 微服 务 都 在 Eureka 服务 器 中 注册 。Eureka 仪表 板 的 地 址 为 http://192.168.99.100: 
8761/， 如 图 14.5 所 示 。 


Instances currently registered with Eureka 

Application ANlls Muailabsilivy ZoOmes 
CCOUNT-SERVICE 

CUSTONER-SERWVICE 


ORDER-SERVICE 


PRODUCT-SERVICE 


图 14.5 在 Eureka 服务 器 中 注册 的 服务 实例 


在 这 里 有 我 们 提 到 过 的 另 一 个 有 趣 的 Docker 命令 : docker stats。 此 命令 打印 一 些 与 
己 启动 容器 相关 的 统计 信息 ， 如 内 存 或 CPU 使 用 情况 。 如 果 使 用 该 命令 的 --format 参数 ， 
则 可 以 目 定 义 打 印 统计 信息 的 方式 。 例 如 ， 可 以 打印 容器 名 称 而 不 是 其 ID。 在 运行 该 命 
令 之 前 ， 可 以 执行 一 些 测试 ， 以 检查 一 切 是 人 否 正 芝 工 作 。 开 发 人 员 可 以 注意 检查 在 容器 
上 局 动 的 微服 务 之 间 的 通信 是 否 已 成 功 完 成 。 此 外 ， 如 果 想 要 党 试 调 用 customer-service 
服务 的 问 点 GET AMwithAccounts/fid} 〈 它 将 调用 account-service 服务 公开 的 端点 ) ， 则 可 
以 运行 以 下 命令 。 


docker stats --format "table 
{{.Name}} \t{{.Container}} \t{{.CPUPerc}}\t{{.MemUsage}}" 


如 图 14.6 所 示 的 是 docker stats 命令 的 打印 结果 。 


NAME CONTATNER 让 MEM USAGE /y LIMIT 
orFder ff2c679alce8e6 dM 2B8.9MiB / = 

了 

了 


83f1i76G61l1des1tf Ss 1393 .6MiB 

SDQe747bdd 人 e822 六 -之子 中 之 1 由 .2MiB 

2BcCcCBffccSsf7 3 品 28939 .8MiB / 
discowvery 本 已 之 十 司 蕊 后 了 祁 名 外 已 - 她 荆 若 255.3MiB / 


图 14.6 ”docker stats 命 


14.4.3 ”使 用 Maven 插件 构建 镜像 


~ 
村 
二 
了 
党 


如 前 文 所 述 ，Dockerfile 不 是 创建 和 构建 容 右 的 唯一 方法 ， 还 有 一 些 其 他 方法 可 用 ， 
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如 使 用 Maven 插件 。 我 们 有 许多 可 用 于 构建 镜像 的 插件 , 它们 与 mvn 命令 一 起 使 用 。 其 
中 一 个 比较 受 欢迎 的 是 com.spotify:docker-Maven-plugin 插件 。 它 在 配置 中 具有 等 效 标记 ， 
可 用 于 代替 Dockerfile 指令 。pom.xml 文件 中 用 于 account-service 服务 的 插件 配置 如 下 。 


<plugin> 
<groupId>com.spotify</groupId> 
<artifactId>docker-maven-plugin</artifactId> 
<Vversion>1.0.0</version> 
<Configuration> 
<imageName>piomin/s$ {project.artifactId}</imageName> 
<jmageTags>s$5{project.version}</imageTags> 
<baseImage>openjdk:8ul1l51-jJdk-slim-stretch</baselImage> 
<entryPoint>["Java".n, "~—Xmxle0m", "™-—jJar"., 
"— Dspring.profiles.active=${SPRING PROFILES ACTIVE}", 
"— Deureka.client.serviceUrl.default2%one=$ {EURERKA DEFAULT ZONE}"™, 
"fs$s{project.build.finalName} .jar"|] </entryPoint> 
<env> 
<SPRING PROFILES ACTIVE>zonel</SPRING PROFILES ACTIVE> 
<EUREKA DEFAULT ZONE>http://localhost:8i76l1/eureka/</EUREKA DEFAULT ZONE> 
</env> 
<exposes>8091</exposes> 
<maintainer>piotr.minkowskiQ@qmail.com</maintainer> 
<dockerHost>https://192.168.99.100:23716</dockerHost> 
<dockerCertPath>C:\Users\Piotr\.docker\machine\machines\default 
</docker CertPath> 
<TeSOUTCeS> 
<resource> 
<directory>s${project.build.directory}</directory> 
<include>s{project.build.finalName} .jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 


可 以 在 Maven 的 build 命令 期 间 调 用 此 插件 。 如 果 想 要 在 构建 应 用 程序 之 后 构建 
Docker 镜像 ， 可 以 使 用 以 下 Maven 命令 。 
$ mvn clean install docker: build 


或 者 ， 开 发 人 员 也 可 以 设置 dockerDirectory 标记 ， 以 便 基 于 Dockerfile 执行 构建 。 无 
论 选 择 哪 种 方法 ， 效 果 都 是 一 样 的 。 使 用 应 用 程序 构建 的 任何 新 镜像 都 可 以 在 Docker 机 
器 上 使 用 。 使 用 docker-maven-plugin 时 ， 可 以 通过 将 pushImage 设置 为 true 来 强制 目 动 
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将 镜像 推送 到 存储 库 ， 如 下 所 示 。 


<plugin> 
<qroupId>com.spotify</groupId> 
<artifactId>docker-maven-plugin</artifactId> 
<version>1.0.0</version> 
<cConfiguration> 
<imageName>piomin/s${project.artifactId}</imageName> 
<imageTags>s5{project.version}</imageTags> 
<pushIimage>true</pushIimage> 
<dockerDirectory>src/main/docker</dockerDirectory> 
<dockerHost>https://192.168.99.100:23716</dockerHost> 
<dockerCertPath>C:\Users\Piotr\.docker\machine\machines\default 
</docker CertPpath> 
<TeSOUTCeS> 
<TeSOUTCe> 
<directory>s$ {project.build.directory}</directory> 
<ijnclude>$5{project.build.finalName} .jar</include> 
</resource> 
</resources> 
</configuration> 
</plugin> 


14.4.4 高 级 Docker 镜像 


到 目前 为 止 ， 我 们 已 经 构建 了 相当 简单 的 Docker 镜像 。 但 是 ， 有 时 需要 创建 更 高 级 
的 镜像 ， 我 们 需要 这 样 的 镜像 用 于 持续 交付 (Continuous Delivery) 演示 。 这 个 Docker 
镜像 将 作为 Jenkins 从 属 (Slave) 服务 器 运行 ， 并 将 连接 到 Jenkins 主 〈Master) 服务器 ， 
作为 Docker 容器 局 动 。 我 们 还 没有 在 Docker Hub 上 找到 这 样 的 镜像 ， 所 以 我 们 自己 创 
建 了 一 个 。 在 这 里 ， 和 镜像 必须 包含 Git、Maven、JDK8 和 Docker。 这 些 是 使 用 Jenkins 从 
属 服务 器 构建 示例 微服 务 所 需 的 所 有 工具 。 我 们 将 在 本 章 的 后 面部 分 简要 介绍 使 用 
Jenkins 服务 器 进行 持续 交付 的 基本 知识 。 目 前 ， 我 们 将 专注 于 构建 所 需 的 镜像 。 以 下 是 
Dockerfile 中 提供 的 镜像 的 完整 定义 。 

FROM docker:18—dind 

MAINTAINER Piotr Minkowski <piotr.minkowskil@amail .com> 

ENV JENKINS MASTER http://localhost:8080 

ENV JENKINS SLAVE NAME dind-node 


ENV JENKINS SLAVE SECRET "™ 
ENV JENKINS HOME /home/jenkins 
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ENV JENKINS REMOTING VERSION 3.11 
ENV DOCKER HOST tcp://0.0.0.0:2315 


RUN apk -update add curl tar git bash open]jdk8 sudo 


ARG MAVEN VERSION=3.3.2 

ARG USER HOME DIR=" /root"™ 

ARG 
SHA=7107blf6e390a65bde4af4cdaf2a24d45fcl9a6ded00fff02e91626e3e42ceaff 
ARG 

BASE URL=https://apache.osuosl.org/maven/maven—3/s{MAVEN VERSION} /binaries 
RUN mkdir -p /usr/share/maven /usr/share/maven/ref AN\ 

&& CuUrl -fsSL -o /tmp/apache-maven.tar.gz S${BASE URL}/apache-maven-— 
S$ {MAVEN VERSION}-bin.tar.gz \ 

&& echo "S${SHA} /tmp/apache-maven.tar.gz" | sha256sum -C 一 NA 

&& tar -xzf /tmp/apache-maven.tar.gz -C /usr/share/maven -strip-— 
components=l1 \\ 

&& rm -f /tmp/apache-—maven.tar.gz \ 

&& ln -s /usr/share/maven/bin/mvn /usr/bin/mvn 

ENV MAVEN HOME /usr/share/maven 

ENV MAVEN CONFIG "SUSER HOME DIR/ .m2" 


RUN adduser -D -h SUENKINS HOME -s /bin/sh jenkins jenkins && chmod 
atrwx SUENKINS HOME 

RUN echo "jenkins ALL= (ALL) NOPASSWD: /usr/local/bin/dockerd™" > 
/etc/sudoers.d/00jenkins && chmod 440 /etc/sudoers.d/00jenkins 

RUN echo "jenkins ALL= (ALL) NOPASSWD: /usr/local/bin/docker™ > 
/etc/sudoers.d/0ljenkins && chmod 440 /etc/sudoers.d/0ljenkins 

RUN curl --create-dirs -SSLO /usr/share/jenkins/slave.jar 
http://repo.jenkins-ci.org/public/org/jenkins-ci/main/remoting/s$JENKINS 
_REMOTING VERSION/remoting—-$JENKINS REMOTING VERSION .JjJar && Chmod /95 
/usr/share/jJjenkins && chmod 644 /usr/share/jenkins/slave.Jjar 


COPY entrypoint.sh /usr/local/bin/entrypoint 
VOLUME S$JENKINS HOME 

WORKDIR S$JENKINS HOME 

USER Jenkins 

ENTRYPOINT ["/usr/local/bin/entrypoint"] 


现在 我 们 来 分 析 一 下 发 生 了 什么 。 在 这 里 ， 我 们 扩展 了 Docker 基础 镜像 。 这 是 一 个 
非常 聪明 的 解决 方案 ， 因 为 该 镜像 现在 已 经 在 Docker 中 提供 了 Docker。 虽然 通常 不 建议 
在 Docker 中 运行 Docker， 但 是 也 有 一 些 理想 的 用 例 ， 例 如 ， 使 用 Docker 进行 持续 交付 。 
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除了 Docker 之 外 ， 还 使 用 RUN 指令 在 镜像 上 安装 其 他 软件 ， 如 Git、JDK、Maven 或 
Curl。 我 们 还 添加 了 一 个 操作 系统 用 户 ， 它 在 dockerd 脚本 中 具有 sudoers 权限 ， 该 脚本 
负责 在 机 器 上 运行 Docker 守护 程序 。 这 不 是 必须 在 正在 运行 的 容器 中 启动 的 唯一 进程 ， 
还 需要 使 用 Jenkins 从 属 服务 器 启动 JAR。 这 两 个 命令 在 entrypoint.sh 中 执行 ， 它 被 设置 
为 镜像 的 ENTRYPOINT。 有 关 此 Docker 镜像 的 完整 源 代 码 ， 请 访问 GitHub， 其 网 址 为 
https://github.com/piomin/jenkins-slave-dind-jnlp.git。 开 发 人 员 不 必 从 源 代 人 码 构 建 它 ， 只 需 
使 用 以 下 命令 从 笔者 的 Docker Hub 账户 下 载 已 准备 好 的 镜像 。 


docker pull piomin / JjJenkins-slave-dind-jnlp 


以 下 是 Docker 镜像 中 的 脚本 entrypoint.sh， 它 启动 了 Docker 守护 进程 和 Jenkins 从 
属 服务 器 。 

#'1 /bin/sh 

set -e 

echo "starting dockerd..." 

sudo dockerd --host=unix:///var/run/docker.sock -- 

host=tcp://0.0.0.0:2375 --storage-driver=vfs & 

echo "starting Jnlp slave..." 

exec Java -jar /usr/share/jJenkins/slave.jJar \ 

-jnlpUr] S$JENKINS URL/computer/$JENKINS SLAVE NAME/slave-agent.jnlp \ 

-Secret SJENKINS SLAVE SECRET 


14.5 持续 交付 


迁移 到 基于 微服 务 的 架构 的 关键 优势 之 一 是 能 够 快速 交付 软件 。 这 应 该 是 在 组 织 中 
实现 持续 交付 或 持续 部 署 过 程 的 主要 动机 。 简 而 言 之 ， 持 续 交 付 流程 是 一 种 尝试 自动 化 
软件 交付 的 所 有 阶段 (如 构建 、 测 试 代码 和 发 布 应 用 程序 ) 的 方法 。 有 许多 工具 可 以 促 
进 这 一 过 程 。 其 中 一 个 是 Jenkins 一 一 一 个 用 Java 编写 的 开源 自动 化 服务 器 。Docker 可 以 
将 持续 集成 (Continuous Integration，CI) 或 持续 交付 (Continuous Delivery，CD) 流程 
提升 到 更 高 的 水 平 。 例 如 ， 不 可 变 交 付 就 是 Docker 最 重要 的 优势 之 一 。 


14.5.1 将 Jenkins 与 Docker 集成 


这 里 的 主要 目标 是 使 用 Jenkins 和 Docker 在 本 地 设计 和 运行 持续 交付 流程 。 在 此 过 
程 中 有 4 个 元 系 。 第 一 个 是 微服 务 的 源 代码 存储 库 ， 这 已 经 准备 好 了 ， 可 以 在 GitHub 上 


。326 。 精通 Spring Cloud 微服 务 架 构 


找到 。 第 二 个 元 素 是 Jenkins， 它 需要 运行 和 配置 。Jenkins 是 持续 交付 系统 的 关键 要 系 。 
它 必须 从 GitHub 存储 库 下 载 应 用 程序 的 源 代 码 ， 构 建 它 ， 然 后 将 生成 的 JAR 文件 放 在 
Docker 镜像 中 ， 并 将 该 镜像 推送 到 Docker Hub， 最 后 运行 包含 微服 务 的 容器 。 此 过 程 中 
的 所 有 任务 都 直接 在 Jenkins 主 服务 器 上 而 不 是 在 其 从 属 节 点 上 执行 。Jenkins 及 其 从 属 节 
点 都 是 作为 Docker 容器 启动 的 。 该 解决 方案 的 架构 说 明 如 图 14.7 所 示 。 


GitHub Jenkins 主 服 务 蜗 Jenkins 从 属 服务 器 Docker Hub 


图 147 将 Jenkins 与 Docker 集成 的 解决 方案 架构 


值得 一 提 的 是 ，Jenkins 是 建立 在 插件 概念 基础 上 的 ， 其 核心 是 一 个 简单 的 日 动 构建 
引擎 。Jenkins 的 真正 威力 在 于 其 插件 ， 在 其 更 新 中 心中 有 数 百 个 插件 。 目 前 ， 由 于 我 们 
要 使 用 的 是 Jenkins 服务 器 ， 因 而 我 们 将 仅 讨 论 一 些 对 此 有 用 的 插件 。 开 发 人 员 需 要 安装 
以 下 插件 才能 在 Docker 容器 中 构建 和 运行 微服 务 。 

口 “管道 (Pipeline) : 这 是 一 套 插 件 ， 它 允许 开发 人 员 按 照管 道 即 代码 (Pipeline as 
Code ) 的 概念 ， 使 用 Groovy 脚本 创建 自动 化 (https://wiki.jenkins.io/display/ 
JENKINS/PipelinetPlugin) 。 

口 Docker 管道 (Docker Pipeline) : 它 人 允许 开 发 人 员 在 管道 中 构建 Docker 容 占 

(https://wiki.jenkins.1i0/display/JENKINS/Dockert+Pipelinet+Pluegin) 。 

口 。Git: 它 可 以 将 Git 与 Jenkins 和 集成 (https://wiki.jenkins.io/display/JENKINS/Git+ 
Plugin) 。 

口 Maven 集成 (Maven Integration〉: 它 在 使 用 Maven 和 Jenkins 构建 应 用 程序 时 
可 以 提供 一 些 有 用 的 命令 (https://plugins.jenkins.io/maven-plugin) 。 

可 以 通过 用 户 界 面 仪 表 板 配置 所 需 的 插件 。 配 置 可 以 在 启动 后 或 通过 Manage Jenkins | 
Manage Plugins( 管 理 Jenkins | 管理 插件 ) 进 行 . 要 在 本 地 运行 Jenkins, 需要 使 用 其 Docker 
镜像 。 以 下 命令 创建 一 个 名 为 jenkins 的 网 络 并 启动 Jenkins 主 容 占 ， 在 端口 38080 上 公 
开 用 户 界 面 仪表 板 。 请 和 注意， 在 第 一 次 启动 Jenkins 容器 并 使 用 其 Web 控制 台 时 ， 需 要 
使 用 初始 生成 的 密码 来 设置 它 。 开 发 人 员 可 以 通过 调用 docker logs jenkins 命令 从 Jenkins 
日 志 中 轻松 检索 此 密码 ， 如 下 所 示 。 

$ docker network create JjJenkins 


$ docker run -d --name JjJenkins -p 38080:8080 -p 50000:50000 --network 
Jenkins Jenkins/jenkins:]lts 
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一 旦 成 功 配置 了 Jenkins 主 服 务 器 及 其 所 需 的 插件 ， 开 发 人 员 就 需要 添加 新 的 从 属 节 
点 。 要 执行 此 操作 ， 可 以 转 到 Manage Jenkins | Manage Nodes (管理 Jenkins | 管理 节点 ) 
部 分 ， 然 后 选择 New Node (新 建 节 点 ) 。 在 显示 的 表单 中 ， 必 须 设置 /home/jenkins 作 
为 远程 根 目 录 ， 并 选择 launch agent via Java Web Start (通过 Java Web Start 启动 代理 ) 作 
为 启动 方法 。 现 在 可 以 局 动 珊 Jenkins 从 属 节 点 的 Docker 容器 ， 如 前 文 所 述 。 请 注意 ， 必 
须 蓝 羡 两 个 指示 从 属 名 称 和 密 钥 的 环境 变量 。name 参数 将 在 节点 创建 期 间 设 置 ， 而 密 铀 
则 由 服务 器 自动 生成 。 开 发 人 员 可 以 查看 节点 的 详细 信息 页 面 以 获取 更 多 信息 ， 如 图 14.8 
所 示 。 


加 Agent dind-node-1 


a -jar deent,jar -jnlpurl] hitp: /192.158.95,1080:38936 computer/dind-node-1/slave-aeent, jnlp -secret 5654Tel451G4basaldacrsmardrreebarc dbhd 3400rnesGBead3432de -workDir “honmerjenkins" 


Projects tied to dind-node-=1 


ne 


14.8 查看 节点 的 详细 信息 页 面 
以 下 是 Docker 命令 ， 它 将 在 Docker 中 使 用 Docker 启动 带 Jenkins 从 属 节 点 的 容器 。 


$ docker run --privileged -d --name slave --network JjJenkins -e 
JENKINS SLAVE SECRET=5664fel46104b89ald2c78920fd9c5eebac3bd71344432e0668 
e366e2d3432d3e -e JENKINS SLAVE NAME=dind-node-l1 -e 


JENKINS URL=http://jenkins:38080 piomin/jenkins-slave-dind-jnlp 


上 述 对 Jenkins 配置 的 简短 介绍 应 该 可 以 帮助 开 友 人 员 在 日 己 的 机 右上 重复 之 前 讨论 
的 持续 交付 流程 。 请 记 住 ， 我 们 只 查看 了 与 Jenkins 相关 的 一 些 方 面 (包括 设置 ) ， 这 些 
方面 允许 开发 人 员 为 自己 的 基于 微服 务 的 系统 设置 CI 或 CD 环境 。 如 果 开 发 人 员 有 兴 
更 深入 地 探讨 此 主题 ， 可 以 访问 https://jenkins.io/doc 以 参考 其 中 的 资料 。 


14.5.2 构建 管 起 


在 旧版 本 的 Jenkins 服务 器 中 ， 基 本 工作 单元 是 作业 (Job) 。 目 前 ， 其 主要 功能 是 
将 管道 定义 为 代码 。 此 更 改 与 IT 架构 中 更 现代 的 趋势 有 关 ， 这 些 趋势 认为 ， 应 用 程序 交 
付 与 正在 交付 的 应 用 程序 一 样 重要 。 由 于 应 用 程序 堆栈 的 所 有 组 件 都 已 自动 化 并 在 版 本 
控制 系统 中 表示 为 代码 ， 因 而 可 以 为 CI 或 CD 管道 利用 相同 的 优势 。 

Jenkins Pipeline 提供 了 一 组 工具 , 用 于 将 简单 和 更 高 级 的 交付 管道 建 模 为 代码 。 这 种 
管道 的 定义 通常 写 入 一 个 名 为 Jenkinsfile 的 文本 文件 中 。 它 支持 领域 特定 语言 (DSL) ， 
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并 通过 共享 库 (Shared Libraries) 功能 提供 其 他 特定 步骤 。Pipeline 支持 两 种 语法 : 声明 
式 语 法 (Declarative ) 和 脚本 管道 (Scripted Pipeline) 。 其 中 ,声明 式 语 法 是 在 Pipeline 2.5 
中 引入 的 。 无 论 使 用 哪 种 语法 ， 它 都 将 在 逻辑 上 划分 为 阶段 〈Stage) 和 步骤 (Step) 。 
步骤 是 管道 中 最 基本 的 部 分 ， 因 为 它们 告诉 Jenkins 要 做 什么 。 阶 段 按 逻辑 组 合 了 奎 干 个 
步骤 ， 然 后 显示 在 管道 的 结果 屏幕 上 。 以 下 代码 是 脚本 管道 的 示例 ， 并 定义 了 account- 


service 服务 的 构建 过 程 。 
必须 为 其 他 微服 务 创建 类 似 的 定义 。 所 有 这 些 定义 都 位 于 每 个 应 用 程序 源 代 人 码 〈 如 


Jenkinsfile) 的 root 目录 中 。 


node(‘dind-node—1") 1 
withMaven (maven: 'M3") I 

stage( Checkout™}) 1 

git url: https://github.com/piomin/sample——spring—cloud-comm.git", 
credentialslId: "github-piomin’',branch: "master’ 


} 


stage(' Build"}) | 
dir('account—service") 1 
sh ‘mn clean install' 
} 
def pom = readMavenPom file: Pom.xml- 
print pom.version 
env .version = pom.version 
CuIrrentBulilld.description = “Release: 


} 


Ss{env.version}" 


stage ("Image') 1 

dir (‘account—service") 1 
def app = docker.build "piomin/account-—-service:${env.version}™ 
app .push () 

} 

} 


stage ( Run ) I{ 
docker.image ("piomin/account-service:${env.version}") .run('-p 8091: 


8091 -d -name account -network sample—spring—cloud-—network") 


} 
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上 述 示例 代码 中 的 定义 分 为 4 个 阶段 。 第 一 个 阶段 是 Checkout， 在 该 阶段 中 克隆 了 
包含 所 有 示例 应 用 程序 源 代 码 的 Git 存储 库 。 第 二 阶段 是 Build， 在 该 阶段 中 从 account- 
service 服务 模块 构建 了 一 个 应 用 程序 ， 然 后 从 root 的 pom.xml 文件 中 读 取 了 整个 Maven 
项 目的 版 本 号 。 第 三 个 阶段 是 Image 阶段 , 在 该 阶段 中 从 Dockerfile 构建 了 一 个 镜像 并 将 
其 推送 到 Docker 存储 库 。 最 后 ， 我 们 在 Run 阶段 运行 了 一 个 带 有 account-service 应 用 程 
序 的 容器 。 所 有 上 述 阶 段 都 在 节点 元 素 的 定义 之 后 在 dind-node-1 上 执行 ， 节 点 元 素 是 管 
道 定义 中 所 有 其 他 元 素 的 根 。 

现在 我 们 可 以 继续 在 Jenkins 的 Web 控制 台中 定义 管道 。 选 择 New Item( 新 建 项 目 )， 
然后 选中 Pipeline 项 目 类 型 并 输入 其 名 称 。 确认 后 应 该 重 定向 到 管道 的 配置 页 面 。 在 该 页 
面 中 , 需要 提供 Git 存储 库 中 Jenkinsfile 的 位 置 , 然后 设置 SCM 身份 验证 凭据 ,如 图 14.9 
所 示 。 

Pipeline 
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图 14.9 配置 管道 
在 保存 更 改 之 后 ， 管 道 的 配置 已 准备 就 绪 。 要 开始 构建 ， 可 单 击 Build Now《〈 立 即 构 
建 ) 按钮 。 在 这 个 阶段 有 两 件 事 需 要 澄清 。 在 生产 模式 中 ， 开 发 人 员 可 以 使 用 webhook 
机 制 ， 该 机 制 由 最 受 欢迎 的 Git 主机 供应 商 提供 ， 包 括 GitHub、BitBucket 和 GitLab。 在 
将 更 改 推送 到 存储 库 后 ， 此 机 制 会 自动 触发 开发 人 员 在 Jenkins 上 的 构建 。 为 了 演示 这 一 
点 ， 开 发 人 员 必 须 使 用 Docker 在 本 地 运行 版 本 控制 系统 ， 如 使 用 GitLab。 还 有 男 一 种 简 
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化 的 测试 方法 ， 那 就 是 容 右 化 应 用 程序 直接 在 Docker 从 属 服务 器 中 的 Jenkins 的 Docker 
上 运行 。 当 然 ， 在 正常 情况 下 ， 开 发 人 员 应 该 在 分 离 的 远程 机 器 上 启动 (该 远程 机 器 专 
门 用 于 部 署 应 用 程序 ) 。 如 图 14.10 所 示 的 就 是 Jenkins 的 Web 控制 台 ， 它 说 明了 按 不 同 
阶段 划分 的 product-service 服务 的 构建 过 程 。 
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图 14.10” 按 不 同 阶段 划分 的 product-service 服务 的 构建 过 程 
现在 应 该 为 每 个 微服 务 创建 一 个 管道 ， 所 有 创建 的 管道 列表 如 图 14.11 所 示 。 
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图 14.11 为 微服 务 创建 的 管道 列表 
14.6 使 用 Kubernetes 


我 们 已 经 在 Docker 容 右 上 局 动 了 示例 微服 务 , 甚至 使 用 了 CI 和 CD 目 动 化 管道 ， 以 
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便 在 本 地 计算 机 上 运行 它们 。 但 是 ， 开 发 人 员 可 能 会 提出 一 个 重要 问题 : 我 们 如 何在 更 
大 规模 和 生产 模式 下 组 织 我 们 的 环境 ,使 我 们 能 够 在 多 台 机 器 上 运行 多 个 容器 ?实际 上 ， 
这 下 是 我 们 根据 云 原 生 开 发 的 思想 实现 微服 务 时 必须 要 做 的 。 事 实证 明 ， 在 这 种 情况 下 
仍然 存在 许多 挑战 。 假 设 开 发 人 员 在 多 个 实例 中 启动 了 许多 微服 务 ， 那 么 将 会 有 大 量 容 
器 需要 管理 。 此 时 的 很 多 操作 “〈 例 如 ， 在 正确 的 时 间 局 动 正 确 的 容器 、 处 理 存 储 的 注意 
事项 、 回 上 或 回 下 扩展 以 及 手动 处 理 故 障 等 ) 对 于 开发 人 员 来 说 都 将 是 一 场 置 楚 。 弟 运 
的 是 ， 有 一 些 平台 可 以 帮助 大 规模 地 集群 和 编排 Docker 容器 。 目 前 ， 走 在 该 领域 前 列 的 
是 Kubernetes。 

Kubernetes 是 一 个 用 于 管理 容器 化 工作 人 名 载 和 服务 的 开源 平台 。 它 可 以 充当 容器 平 
台 、 微 服务 平台 、 云 平台 等 。 它 可 以 目 动 执行 以 下 操作 ， 跨 不 同 计算 机 运行 容器 、 同 上 
和 同 下 扩展 、 在 容器 之 间 分 配 鸳 载 ， 以 及 在 应 用 程序 的 多 个 实例 之 则 保持 存储 的 一 致 性 。 
它 还 具有 许多 其 他 功能 ， 包 括 服务 发 现 、 负 载 均衡 、 配 置 管理 、 服 务 命 名 和 深 动 更 新 等 。 
当然 ， 并非 所 有 这 些 功 能 都 对 开发 人 员 有 用 ， 因 为 Spring Cloud 也 提供 了 许多 类 似 的 功能 。 

值得 一 提 的 是 ,Kubemetes 不 是 唯一 的 容器 管理 工具 。 类 似 的 工具 还 有 Docker Swarm， 
它 是 Docker 中 提供 的 原生 工具 。 但 是 ， 由 于 Docker 己 经 宜 布 了 对 Kubemetes 的 原生 文 
持 ， 所 以 它 看 起 来 也 是 一 个 很 目 然 的 选择 。 在 详细 讨论 任何 实际 示例 之 前 ， 开 发 人 员 应 
该 知道 天 于 Kubernetes 的 几 个 重要 概念 和 组 件 。 


14.6.1 概念 和 组 件 


使 用 Kubemetes 时 可 能 需要 理解 的 第 一 个 术语 是 pod， 它 是 Kubermnetes 的 基本 构建 
块 。pod 表示 集群 中 正在 运行 的 进程 。 它 可 以 由 一 个 或 多 个 容器 组 成 ， 这 些 容器 保证 共存 
在 主机 上 并 将 共享 相同 的 资源 。 每 个 pod 一 个 容器 就 是 最 常见 的 Kubemetes 用 例 。 每 个 
pod 在 集群 中 都 有 唯一 的 卫 地 址 ， 但 部 署 在 同一 pod 中 的 所 有 容器 都 可 以 通过 localhost 
与 其 他 容器 进行 通信 。 

另 一 个 种 见 的 组 件 是 服务 。 服 务 可 以 在 逻辑 上 对 一 组 pod 进行 分 组 ， 并 定义 访问 它 
的 策略 。 它 有 时 被 称 为 微服 务 。 默 认 情 况 下 ， 有 上 服务 在 集群 内 部 公开 ， 但 也 可 以 公开 到 外 
部 IP 地 址 。 开 发 人 员 可 以 使 用 以 下 4 种 可 用 行为 之 一 公开 服务 : ClusterIP、NodePort、 
LoadBalancer 和 ExtemalName。 默 认 选 项 是 ClusterIP。 这 会 在 集群 内 部 IP 上 公开 服务 ， 
这 也 使 得 它 只 能 从 集群 内 部 访问 。 

NodePort 将 公开 每 个 节点 的 IP 在 静态 端口 上 的 服务 , 并 上 自动 创建 ClusterIP 以 在 集群 
内 公开 服务 。 反 过 来 ，LoadBalancer 将 使 用 云 提 供 商 的 负载 均衡 器 在 外 部 公开 服务 ， 
ExternalName 可 以 将 服务 映射 到 externalName 字段 的 内 容 。 这 里 还 应 该 花 点 时 间 来 讨论 
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Kubernetes 的 副本 控制 器 (Replication Controller) 。 它 通过 在 集群 中 运行 指定 数量 的 pod 
剧本 来 处 理 副 本 和 扩展 。 如 果 底 层 节 点 出 现 故 障 ， 它 还 负责 蔡 换 pod。Kubernetes 中 的 每 
个 控制 器 都 是 通过 kube-controller-manager 运行 的 独立 进程 。 开 发 人 员 还 可 以 在 
Kubernetes 中 找到 节点 控制 器 (Node Controller) 、 交 点 控制 露 (Endpoint Controller) 以 
及 服务 账户 和 令 牌 控制 骼 。 

Kubernetes 使 用 etcd 键 / 值 存储 作为 所 有 集群 数据 的 后 备 存储 。 在 集群 的 每 个 节点 内 
都 有 一 个 名 为 kubelet 的 代理 ， 它 负责 确保 容器 在 pod 中 运行 。 用 户 发 送 给 Kubernetes 的 
每 个 命令 都 由 kubeapi-server 公开 的 Kubernetes API 处 理 。 

当然 ， 以 上 只 是 对 Kubernetes 架构 的 一 个 非常 简化 的 解释 。 有 许多 组 件 和 工具 必须 
正确 配置 才能 成 功 运行 高 可 用 性 Kubernetes 集群。 这 不 是 一 项 简单 的 任务 ， 它 需要 大 量 
有 关 此 平台 的 知识 。 溺 运 的 是 ， 有 一 个 工具 可 以 轻松 地 以 本 地 方式 运行 Kubernetes 集群 ， 
这 个 工具 就 是 Minikube。 


14.6.2 ”通过 Minikube 以 本 地 方式 运行 Kubernetes 


Minikube 是 一 种 工具 ， 可 以 按 本 地 方式 轻松 运行 Kubernetes。 它 在 本 地 计算 机 上 的 
虚拟 机 内 运行 单 节点 Kubernetes 集群 . 它 绝对 是 开发 模式 中 最 合适 的 选择 。 当 然 ,Minikube 
并 不 文 持 Kubernetes 提供 的 所 有 功能 ， 只 提供 了 对 最 重要 功能 的 文 持 ， 包 括 DNS、 
NodePorts、Confie Map、Dashboard 和 Ingress 等 。 

要 在 Windows 上 运行 Minikube， 需 要 安装 虚拟 化 工具 。 当 然 ， 如 果 开 发 人 员 已 经 运 
行 了 Docker， 那 么 很 可 能 已 经 安装 了 Oracle VM VirtualBox。 在 这 种 情况 下 ， 除 了 下 载 并 
安装 Minikube 的 最 新 版 本 之 外 ,不必 执 行 任何 其 他 操作 。 开 发 人 员 可 以 查看 
https://github.conykubernetes/minikube/releases 和 kubectlexe， 其 文本 说 明 的 地 址 为 
https://storage.googleapis.com/kubernetes-release/release/stable.txt 。 文件 minikube.exe 和 
kubectl.exe 都 应 包含 在 PATH 环境 变量 中 。 此 外 ，Minikube 还 提供 了 自己 的 安装 程序 
minikube-installer.exe， 它 会 自动 将 minikube.exe 添加 到 路 径 中 。 然 后 ， 开 发 人 员 可 以 通 
过 运行 以 下 命令 从 命令 行 局 动 Minikube。 

$ minikube start 


以 上 命令 将 初始 化 一 个 名 为 minikube 的 kubectl 上 下 文 。 它 包含 允许 开发 人 员 与 
Minikube 集群 通信 的 配置 。 现 在 可 以 使 用 kubectl 命令 来 维护 由 Minikube 创建 的 本 地 集 
群 ， 并 在 那里 部 署 容器 。 命 令 行 界面 的 蔡 代 解决 方案 是 Kubernetes 仪表 板 。 可 以 通过 调 
用 minikube 仪表 板 为 节点 启用 Kubernetes 仪表 板 。 开 发 人 员 可 以 使 用 此 仪表 板 创建 、 更 
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新 或 删除 部 普 ， 以 及 列 出 和 得 看 所 有 pod、 服 务 、 入 口 和 副本 控制 器 的 配置 。 通 过 调用 以 
下 命令 可 以 轻松 地 停止 和 删除 本 地 集群 。 


$ minikube stop 
$ minikube delete 


14.6.3 ”部 署 应 用 程序 


Kubernetes 集群 上 现 有 的 每 个 配置 都 由 Kubemetes 对 象 表 示 。 这 些 对 象 可 以 通过 
Kubernetes API 进行 管理 ， 并 且 应 该 以 YAML 格式 表示 。 开 发 人 员 可 以 直接 使 用 该 APTL， 
但 也 可 以 利用 kubectl 命令 行 界 面 进行 所 有 必要 的 调用 。Kubernetes 中 新 创建 的 对 象 的 摘 
述 必 须 提供 描述 其 所 需 状 态 的 规范 ， 以 及 有 关 该 对 象 的 一 些 基 本 信息 。 以 下 是 应 始终 设 
置 的 YAML 配置 文件 中 的 一 些 必 填 字段 。 

口 apiVersion: 这 表示 用 于 创建 对 象 的 Kubernetes API 的 版 本 。API 总 是 在 请 求 中 

需要 JSON 格式 ， 但 kubectl 会 目 动 将 YAML 输入 转换 为 JSON。 
kind: 设置 要 创建 的 对 象 的 类 型 。 有 一 些 预定 义 类 型 可 用 ， 如 Deployment、 
Service、Ineress 或 ConfigMap 。 

口 metadata: 这 允许 开 有 故 人 员 通 过 名 称 、UID 或 可 选 命名 空间 来 标识 对 象 。 

口 spec: 这 是 对 象 的 正确 定义 。 规 范 的 精确 格式 取决 于 对 象 的 类 型 ， 并 包含 特定 于 
该 对 象 的 舱 套 字段 。 

一 般 来 说 ， 在 Kubernetes 上 创建 新 对 象 时 ， 其 kind 是 Deployment。 在 如 下 所 示 的 
Deployment YAML 文件 中 ， 有 两 个 重要 的 字段 设置 。 第 一 个 字段 是 replicas， 它 指定 了 所 
需 pod 的 数量 。 实 际 上 ， 这 意味 着 开发 人 员 运 行 容 右 化 应 用 程序 的 两 个 实例 。 第 二 个 字 
段 是 spec.template.spec.containers.image， 它 设置 将 在 pod 中 启动 的 Docker 镜像 的 名 称 和 
版 本 。 该 容器 将 在 端口 8090 上 公开 ， 而 order-service 服务 也 将 在 端口 8090 上 侦 听 HTTP 

apiVersion: apps/vl 

kind: Deployment 

metadata: 

name: order—Sservice 
Spec: 

replicas: 2 

selector: 


matchLabels: 


app: Order—serVvice 
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template: 
metadata: 
labels: 
app: Order—service 
和 各 和 
containers: 
“name: Order service 
image: piomin/order-service:1.0 
emV : 
— name: EUREKA DEFAULT ZONE 
Value: http://discovery-service:8761/eureka 
ports: 
— containerPort: 8090 
protocol: TCP 


假设 上 述 代 码 存储 在 文件 order-deployment.yaml 中 ， 那 么 开发 人 员 就 可 以 使 用 命令 
管理 方式 在 Kubernetes 上 部 署 上 自己 的 容器 化 应 用 程序 ， 如 下 所 示 。 


$ kubectl create -f order-deployment .yaml 


或 者 ， 也 可 以 基于 声明 式 管 理 方 式 执行 相同 的 操作 ， 如 下 上 所 示 。 
$ kubectl apply -上 E order-depLovmnent .yaml] 


现在 开发 人 员 必 须 为 所 有 微服 务 和 discovery-service 服务 创建 相同 的 部 署 文 件 。 
discovery-service 服务 的 客体 是 一 个 非常 硕 望 了 解 的 事项 。 开 友人 员 可 以 选择 使 用 基于 pod 
和 服务 的 内 置 Kubernetes 发 现 , 但 这 里 的 主要 目标 是 在 该 平台 上 部 署 和 运行 Spring Cloud 
组 件 , 因此 , 在 部 署 任何 微服 务 之 前 , 首先 应 该 在 Kubernetes 上 部 署 、 运 行 和 公开 Eureka。 
以 下 是 discovery-service 的 部 署 文 件 ， 它 也 可 以 通过 调用 kubectl apply 命令 应 用 于 
Kubernetes.。 

apiVersion: apps/vl 

kind: Deplovyment 

metadata: 

name: discovery—Service 


labels: 
run: discovery—Service 


spec: 
replicas: 1 
| rt 
matchLabels: 


app: discovery—service 
template: 
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metadata: 
Tabels: 
app: discovery—Service 
Spec: 
containers: 
- name: dliscovery—Service 
image: piomin/discovery-service:1.0 
ports: 
- ContainerPort: 8161 
Proteocol: FCP 


如 果 创 建 的 是 Deployment 类 型 的 对 象 ， 则 Kubernetes 会 自动 创建 pod。 它 们 的 数量 
等 于 replicas 字段 中 设置 的 值 。pod 无 法 公开 由 部 署 在 容器 上 的 应 用 程序 提供 的 API， 它 
只 表示 集群 上 正在 运行 的 进程 。 要 访问 在 pod 中 运行 的 微服 务 提供 的 API， 必 须 定义 一 
个 服务 。 那 么 这 里 的 服务 是 什么 ? 服务 是 一 种 抽象 ， 它 定义 了 一 组 逻辑 pod 和 一 个 访问 
它们 的 策略 。 服 务 所 针对 的 一 组 pod 通常 由 标签 选择 器 确定 。 Kubernetes 提供 了 4 种 服务 
类 型 ， 最 简单 和 默认 的 是 ClusterIP， 它 在 内 部 公开 服务 。 如 果 要 从 集群 外 部 访问 服务 ， 
则 应 定义 NodePort 类 型 。 此 选项 已 在 以 下 示例 YAML 文件 中 列 出 。 现在， 所 有 微服 务 都 
可 以 使 用 其 Kubernetes 服务 名 称 与 Eureka 进行 通信 。 

apiVersion: vl 

ki SeTYICE 

metadata: 

name: discCovery—-SerVvice 
labels: 
app: dliscovery—Service 
spec: 
type: NodePort 
ports: 
- Protocol: “TCP 
port: 81716] 
targetPort: 8/61 
selector: 
app: discCoOovery—SsService 


事实 上 ， 部 署 在 Minikube 上 的 所 有 微服 务 都 应 该 在 集群 外 部 使 用 ， 因 为 开发 人 员 希 
望 访问 它们 公开 的 API。 为 此 ， 需 要 提供 与 前 面 示例 中 类 似 的 YAML 配置 ， 当 然 也 别 扎 
记 更 改 服务 的 名 称 、 标 签 和 端口 。 

在 我 们 的 架构 中 ， 现 在 应 该 只 剩 下 最 后 一 个 组 件 还 未 介绍 : API 网 关 。 开 发 人 员 当 
然 可 以 使 用 Zuul 代理 部 署 容 器 ， 但 是 这 里 我 们 想 要 介绍 男 一 个 流行 的 Kubernetes 对 象 : 
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Ingress。 该 组 件 负责 管理 通过 HTTP 公开 的 服务 的 外 部 访问 。Ingress 可 以 提供 负载 均衡 、 
SSL 终端 和 基于 名 称 的 虚拟 主机 。Ingress 配置 YAML 文件 如 下 所 示 。 请 注意 ， 可 以 在 不 
同 URL 路 径 上 的 同一 端口 80 上 访问 所 有 服务 。 


apiVersion: extensions/vilbetal 
kind: Ingress 
metadata: 
name: gateway—ingress 
SpeEc: 
backend: 
ServiceName: default-—http-backend 
ServicePort: 80 
rules: 
一 haest: mIiCroservices.example.pl 
http: 
paths: 
- path: /account 
backend: 
ServiceName: account—service 
ServicePort: 8091 
- path: /customer 
backend: 
ServiceName: customer— service 
ServicePort: 8092 
—- path: /order 
backend: 
ServVviceName: order—service 
SerVIiCePort: 8090 
~- Path: product 
backend: 
ServiceName: product—service 
ServicePort: 8093 


14.6.4 维护 集群 


维护 Kubernetes 集群 相当 复杂 。 本 节 将 演示 如 何 使 用 一 些 基本 命令 和 用 户 界 面 仪表 
板 来 得 看 集群 上 当前 存在 的 对 象 。 这 里 不 妨 列 出 为 运行 基于 微服 务 的 示例 系统 而 创建 的 
元 素 。 要 完成 此 操作 ， 首 先 可 以 通过 运行 kubectl get deployments 命令 显示 部 署 列 表 ， 这 
将 导致 如 图 14.12 所 示 的 结果 。 

一 个 部 署 可 以 创建 许多 pod。 开发 人 员 可 以 通过 调用 kubectl get pods 命令 来 检查 pod 
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列表 ， 如 图 14.13 所 示 。 


Daployments 


图 14.12 显示 部 署 列表 


C:\Users\minkowp>kubectl get pods 

NAME READY STRTUS RESTARTS AGE 
account-serulce-Sefdcrcfrg9-nkrfn 171 Running 
discouvery-servuice-dcdb86b7Tb-szlSb 1/1 Running 
order-serulce-7?96bbf8975-fbd9z 171 Running 
order-seryulce-7?96bbf68975-z4Sf6 171 Running 
product-servlice-7?8dd?b5s53c-rnmkp 171 Running 


图 14.13 ”通过 调用 kubectl get pods 命令 来 检查 pod 列表 


可 以 通过 用 户 界 面 仪表 板 来 得 看 相同 的 列表 。 开 上 有 人员 可 以 通过 单 击 所 选 行 来 得 看 
这 些 详 细 信 息 ， 或 者 通过 单 击 每 行 右 侧 的 可 用 图 标 来 得 看 容 邵 日 志 ， 如 图 14.14 所 示 。 


图 14.14 ”通过 用 户 界 面 仪表 板 来 得 看 pod 列表 


可 以 使 用 命令 kubectl get services 显示 可 用 服务 的 完整 列表 ， 如 图 14.15 所 示 。 这 里 

有 一 些 有 趣 的 字段 ， 包 括 一 个 表示 集群 内 可 用 服务 的 卫 地 址 〔〈CLUSTER-P) 和 一 对 端口 

(PORT(S)) ， 它 们 的 服务 将 在 内 部 和 外 部 公开 。 还 可 以 在 地 址 http://192.168.99.100:31099 

上 调用 由 account-service 服务 公开 的 HITP API， 或 者 在 地 址 http://192.168.99.100:31931 
上 访问 Eureka 用 户 界面 仪表 板 。 


CE:NUSerssmImKOUP>KUbect1 get services 

NAME TYPE EXTERNAL-IP PORT(S) 
account-servlice NodePort 18. <None> 8091:31099/TCP 
discovery-service NodePort 10.98.219.32 “hnone» 8761:31931/TCP 


kubernetes ClusterIP 18.368.08.1 <hNone> 凡生 六 TCR 
orderFr-servyice NodePort .98.218.69 <hone> 8090:30837ATCP 
product-servuice NodePort 10 .398.83.89 “None> 8093: 30363/TCP 


图 14.15 使 用 命令 kubectl get services 显示 可 用 服务 的 完整 列表 
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与 以 前 的 对 象 类 似 ， 也 可 以 使 用 Kubernetes 仪表 板 来 显示 服务 ， 如 图 14.16 所 示 。 


图 14.16 使 用 Kubernetes 仪表 板 显示 的 服务 列表 
14.7 小 结 


本 章 讨 论 了 许多 与 Spring Cloud 无 明显 关联 的 主题 ， 但 本 章 中 介绍 的 工具 将 允许 开 
发 人 员 充 分 利用 迁移 到 基于 微服 务 的 架构 的 优势 。 当 使 用 Docker、Kubermetes 或 持续 集 
成 /持续 交付 (CLCD) 工具 时 , 使 用 Spring Cloud 进行 云 原生 开发 具有 明显 的 优势 。 当 然 ， 
所 有 提供 的 示例 都 已 在 本 地 计算 机 上 启动 ， 但 开发 人 员 可 以 参考 这 些 示 例 来 设想 如 何在 
跨 远 程 计算 机 集群 的 生产 环境 中 设计 该 过 程 。 

本 章 向 开发 人 员 演 示 了 如 何 简 单 快捷 地 从 在 本 地 计算 机 上 手动 运行 Spring 微服 务 转 
移 到 从 源 代码 构建 应 用 程序 的 全 目 动 化 流程 ， 使 用 应 用 程序 创建 和 运行 Docker 镜像 ， 并 
将 其 部 署 在 由 多 台 计 算 机 组 成 的 集群 上 。 想 要 在 同一 章 中 描述 Docker、Kubernetes 和 
Jenkins 等 复杂 工具 提供 的 所 有 功能 并 不 容易 ， 所 以 ， 本 章 的 主要 目的 是 让 开发 人 员 了 解 
如 何 基 于 容器 化 、 上 自动 部 署 、 扩 展 和 私有 云 等 概念 设计 和 维护 现代 架构 的 宏观 知识 。 

我 们 现在 已 经 接近 本 书 的 结尾 了 。 我 们 已 经 讨论 了 与 Spring Cloud 框架 相关 的 大 多 
数 计划 主题 。 第 15 章 将 展示 如 何 使 用 Web 上 可 用 的 两 个 最 流行 的 云 平台 ， 从 而 允许 开 
发 人 员 持 续 交 付 Spring Cloud 应 用 程序 。 
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Pivotal 公司 将 Spring Cloud 定义 为 加 速 云 原生 应 用 程序 开发 的 框架 。 今 天 ， 当 我 们 
谈论 云 原生 应 用 程序 时 ， 首 先 想到 的 是 快速 交付 软件 的 能 力 。 为 了 满足 这 些 需 求 ， 开 发 
人 员 应 该 能 够 快速 构建 可 扩展 、 可 移植 且 准 备 频 繁 更 新 的 新 应 用 程序 和 设计 架构 。 提 供 
容器 化 和 编排 机 制 的 工具 有 助 于 开发 人 员 建 立 和 维护 这 样 的 架构 。 实 际 上 ， 本 书 前 面 章 
节 中 已 经 讨论 过 Docker 或 Kubernetes 等 工具 ,它们 都 允许 开发 人 员 创 建 日 己 的 私有 云 并 
在 其 上 运行 Spring Cloud 微服 务 。 虽 然 应 用 程序 不 必 部 署 在 公共 云 上 ， 但 它 包 含 云 软件 
的 所 有 最 重要 的 特征 。 

在 公共 云 上 部 署 Spring 应 用 程序 只 是 一 种 可 能 性 ， 而 不 是 必需 的 。 但 是 ， 有 一 些 非 
常 有 趣 的 云 平台 允许 开发 人 员 在 几 分 钟 内 轻松 运行 微服 务 并 在 网 络 上 公开 它们 。 其 中 一 
个 平台 就 是 Pivotal Cloud Foundry (PCF》〉， 它 优 于 其 他 平台 的 优势 在 于 它 对 Spring Cloud 
服务 的 原生 支持 ， 包 插 使 用 Eureka、Config Server 和 Hystrix 断路 器 进行 发 现 。 开 发 人 员 
还 可 以 通过 启用 Pivotal 提供 的 代理 服务 轻松 设置 完整 的 微服 务 环 境 。 

本 章 将 要 介绍 的 男 一 个 云 平台 是 Heroku。 与 PCF 相 比 ， 它 不 支持 任何 编程 框架 。 
Heroku 是 一 个 完全 托管 的 多 语言 平台 ， 可 以 让 开发 人 员 快 速 交 付 软 件 。 一 旦 推送 了 对 存 
储 在 GitHub 存储 库 中 的 源 代码 的 更 改 ， 它 就 可 以 自动 构建 和 运行 应 用 程序 。 它 还 提供 了 
许多 附加 服务 ， 可 以 使 用 单个 命令 进行 配置 和 扩展 。 

本 章 将 要 讨论 的 主题 包括 : 

口 ”Pivotal Web Services 平台 简介 。 

口 ”使 用 CLI、Maven 插件 和 用 户 界面 仪表 板 在 Pivotal Cloud Foundry 上 部 署 和 管理 

应 用 程序 。 

口 ”使 用 Spring Cloud Foundry 库 准 备 应 用 程序 以 使 其 在 平台 上 正常 工作 。 

口 在 Heroku 平台 上 部 署 Spring Cloud 微服 务 。 

口 ”管理 代理 服务 。 


1S.1 Pivotal Cloud Foundry 


虽然 Pivotal 平台 可 以 运行 用 多 种 语言 编写 的 应 用 程序 ， 如 Java、.NET、Ruby、 
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JavaScript、Python、PHP 和 Go 等 ， 但 它 对 Spring Cloud Services 和 Netflix OSS 工具 提供 
了 最 好 的 支持 。 这 非常 有 意义 , 因为 他 们 是 开发 Spring Cloud 的 人 。 图 15.1 说 明了 Pivotal 
Cloud 平台 提 供 的 基于 微服 务 的 染 构 (该 图 的 英文 版 也 可 以 在 Pivotal 的 官方 网 站 上 找到 )。 
开发 人 员 可 以 在 Cloud Foundry 上 使 用 Spring Cloud 快速 利用 常见 的 微服 务 模式 ， 包 括 分 
布 式 配 置 管理 、 服 务 发 现 、 动 态 路 由 、 负 载 均衡 和 容错 等 。 


dd 人，SCS 服务 注册 表 
云 控制 器 PCF UAA 服务 发 现 ” 


和 | * 
i | 
CGE) [EE OAuth2 no 


| 
rs | de : 
PCF 路 由 器 。 “人 网关 


OE 名 


Pivotal 
Tracker 


到 15.1 Pivotal Cloud 平台 提供 的 基于 微服 务 的 架构 
15.1.1 使 用 模式 


开发 人 员 可 以 按 3 种 不 同 的 模式 使 用 Pivotal 平台 。 这 些 模 式 是 根据 主机 进行 区 分 的 ， 
而 主机 就 是 部 署 应 用 程序 的 位 置 。 以 下 是 可 用 解决 方案 的 列表 。 

口 “PCF Dev: Pivotal 平台 的 这 个 实例 可 以 在 一 台 虚 拟 机 上 以 本 地 方式 运行 。 它 专 为 
实验 和 开发 需求 而 设计 。 它 不 提供 所 有 可 能 的 功能 和 服务 。 例 如 ， 只 有 一 些 诸 
如 Redis、MySQL 和 RabbitMQ 之 类 的 内 置 服务 。 但 是 ，PCF Dev 还 文 持 Spring 
Cloud Services (SCS) 以 及 完整 版 PCF 中 支持 的 所 有 语言 。 值 得 注意 的 是 ， 如 果 
开发 人 员 想 要 以 本 地 方式 运行 包含 SCS 的 PCF Dev， 则 需要 超过 6 GB 的 内 存 。 

口 ”Pivotal Web Services: 这 是 一 个 可 在 线 访问 的 云 原生 平台 ， 网 址 为 https:/run. 
pivotal.io/。 它 就 像 Pivotal Cloud Foundry 一 样 , 提高 托管 功能 , 并 且 按 小 时 付费 。 
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它 不 提供 Pivotal Cloud Foundry 中 提供 的 所 有 功能 和 服务 。 例 如 ， 开 发 人 员 可 以 
只 局 用 由 Pivotal 的 Saas 合作 伙伴 提供 的 服务 。Pivotal Web Services 最 适合 初创 
公司 或 个 人 团队 。 我 们 将 在 本 章 后 面 的 小 节 中 使 用 此 Pivotal 平台 托管 模型 进行 
演示 。 

口 “Pivotal Cloud Foundry: 这 是 一 个 功能 齐全 的 云 原 生平 台 ， 可 在 任何 主要 的 公共 
Iaas 上 运行 ， 包 括 AWS、Azure 和 Google Cloud Platform， 或 者 基于 OpenStack 
或 VMware vSphere 的 私有 云 。 它 是 适用 于 大 型 企业 环境 的 商业 解决 方案 。 


15.1.2 ”准备 应 用 程序 


由 于 Pivotal Web Services 对 Spring Cloud 应 用 程序 具有 原生 文 持 ， 因 而 部 署 过 程 非 
币 简 单 。 但 是 ， 它 确实 需要 在 应 用 程序 端 具有 特定 的 依赖 项 和 配置 一 特别 是 如 条 开发 
人 员 的 微服 务必 须 与 Pivotal 平台 (如 Service Registry、Config Server 或 Circuit Breaker ) 
提供 的 内 置 服务 集成 的 话 ， 更 是 如 此 。 除 了 Spring Cloud 的 标准 依赖 项 管理 之 外 ， 还 应 
该 在 pom xml 中 包含 spring-cloud-services-dependencies, 最 新 版 本 与 Edgware.SR2 版 本 列 
车 一 起 使 用 ， 如 下 所 示 。 
<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
<Version>Edgware.SR2</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
<dependency> 
<gqroupId>io.pivotal.spring.cloud</groupId> 
<artifactId>spring-cloud-services-dependencies</artifactId> 
<Version>1.6.1 .RELEASE</version> 
<type>pom</type> 
<Scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 


根据 所 选 的 集成 服务 ， 开 发 人 员 可 能 希望 在 项 目 中 包含 以 下 工件 。 我 们 决定 使 用 
Pivotal 平台 提供 的 所 有 Spring Cloud 功能 ， 因 此 ， 我 们 的 微服 务 将 获取 配置 服务 器 的 属 
性 ， 在 Eureka 中 注册 它们 ， 并 使 用 Hystrix 命令 包装 服务 则 通信 。 
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以 下 是 为 在 Pivotal 平台 上 部 闭 的 应 用 程序 局 用 发 现 客户 靖 、 配 置 客户 病 和 新 路 器 所 
需要 的 依赖 项 。 


<dependency> 
<gqrouplId>io.pivotal .spring.cloud</groupId> 
“artifactId>spring cloud services starter circecuit breaker 
</artifactId> 
</dependency> 
<dependency> 
<gqrouplId>io.pivotal .spring.cloud</groupId> 
<artifactId>spring-cloud-services-starter-config-client</artifactId> 
</dependency> 
<dependency> 
<grouplId>io.pivotal .spring.cloud</groupId> 
<artifactIid>spring-cloud-services-starter-service-registry</artifactId> 
</dependency> 


我 们 将 为 示例 微服 务 提供 更 多 和 集成。 所 有 这 些 都 将 在 MongoDB 中 存储 数据 ， 而 
MongoDB 也 可 以 作为 Pivotal 平台 上 的 服务 提供 。 要 完成 此 目标 ， 首 先 应 该 在 项 目 依赖 
项 中 包含 starter spring-boot-starter-data-mongodb 。 

<dependency> 

<groupId>org.springframework.boot</groupId> 
<artifactIid>spring-boot-—starter-data—mongodb</artifactId> 
</dependency> 

应 该 使 用 spring.data.mongodb.uri 属性 在 配置 设置 中 提供 MongoDB 数据 库 的 地 址 。 
为 了 允许 应 用 程序 与 MongoDB 数据 库 连 接 , 我们 必须 创建 一 个 Pivotal 的 服务 mLab， 然 
后 将 其 绑 定 到 应 用 程序 。 默 认 情 况 下 ， 与 绑 定 服务 相关 的 元 数据 将 作为 环境 变量 
$VCAP SERVICES 公开 给 应 用 程序 。 这 种 方法 的 主要 动机 是 Cloud Foundry 被 设计 为 多 
语言 ， 这 意味 着 任何 语言 和 平台 都 可 以 作为 构建 包 (Buildpack) 获得 支持 。 可 以 使 用 vcap 
前 级 注入 所 有 Cloud Foundry 属性 .如 果 想 要 访问 Pivotal 的 服务 , 则 应 该 使 用 vcap.services 
前 级 ， 人 然后 传递 如 下 所 示 的 服务 名 称 。 

spring: 

data: 


mongodb: 
uri: S${vcap.services.mlab.credentials .uri)} 


实际 上 ， 这 束 是 震 要 在 应 用 程序 端 完成 的 所 有 工作 ， 这 样 就 可 以 使 它们 与 Pivotal 平 
人 台 上 创建 的 组 件 一 起 正常 工作 。 现 在 我 们 必须 与 在 Spring 中 编写 的 标准 微服 务 相 同 的 方 


第 15 章 云 平台 上 的 Spring 微服 务 343。 


式 启用 Spring Cloud 功能 ， 如 下 所 示 。 


QSpringBootApplication 
QEnableDiscoveryClient 
QEnableFeignClients 
QEnableCircuitBreaker 

public class OrderApplication 1 


Public static void main(String[|] args) 1 
SpringApplication.run(OrderApplication.class, args)}; 


} 


15.1.3 ”部署 应 用 程序 


可 以 通过 3 种 不 同 的 方式 在 Pivotal Web Service (PWS) 平台 上 管理 应 用 程序 。 第 一 
种 方式 是 通过 https://console.run.pivotal.io 上 提供 的 Web 控制 台 。 开 发 人 员 可 以 通过 这 种 
方式 监控 、 扩 展 、 重 新 局 动 已 部 署 的 应 用 程序 ， 局 用 和 禁用 服务 ， 定 义 新 指标 以 及 更 改 
账户 设置 。 但 是 ， 使 用 Web 控制 台 【〈 换 句 话 说 ， 也 就 是 初始 应 用 程序 部 署 ) 却 无 法 执行 
此 操作 ， 它 需要 使 用 命令 行 界面 (Command-Line Interface，CLI) 执行 。 开 发 人 员 可 以 从 
pivotalio 网 站 下 载 所 需 的 安装 程序 。 安 装 完成 之 后 ， 即 可 通过 输入 cf 来 调用 计算 机 上 的 
Cloud Foundry CLI, 如 cfhelp。 

1. 使 用 命令 行 表面 

命令 行 界面 提供 了 一 组 命令 ,允许 开 友 人 员 在 Cloud Foundry 上 管理 应 用 程序 、 代 理 
的 服务 、 空 间 、 域 和 其 他 组 件 等 。 接 下 来 将 介绍 在 PWS 上 运行 应 用 程序 时 应 该 知道 的 最 
重要 的 命令 。 

(1) 要 部 署 应 用 程序 , 必须 先导 航 到 其 目录 。 然 后 , 应 该 使 用 cf login 命令 登录 PWS， 

如 下 所 示 。 


$ cf login -a https://api.run.pivotal.io 


(2) 使 用 cf push 命令 将 应 用 程序 推送 到 Pivotal Web Service， 并 传递 服务 的 名 称 。 


$ cf push account-service -p target / account-service-1.0.0- 
SNAPSHOT .JjJar 


(3) 或 者 ， 开 发 人 员 也 可 以 在 应 用 程序 的 根 目录 中 提供 manifest.yml 文件 以 及 所 有 
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必需 的 部 署 设 置 。 在 这 种 情况 下 ， 开 发 人 员 只 需 运行 cf push 命令 而 无 须 任何 其 他 参数 ， 
如 下 所 示 。 
applications: 
-Tame: ACCOUNt service 
memory: 300M 
random-—route: true 
path: target/account—service--l1.0—SNAPSHOT.Jar 
(4) 使 用 如 上 例 所 示 的 manifest.yml 文件 中 提供 的 配置 设置 进行 部 署 将 失败 。 要 得 
看 原因 ， 可 以 运行 命令 cflogs。 原 因 是 堆 的 内 存 限 制 不 足 。 


$ cf logs account-service --recent 


驮 认 情 况 下 ， 平 台 将 为 代码 缓存 分 配 240MB， 为 元 空间 (Metaspace) 分 配 140MB， 
为 每 个 线程 分 配 1MB， 并 假设 Tomcat 连接 规 最 多 有 200 个 线程 。 这 样 就 很 容易 计算 出 ， 
使 用 这 些 设置 ， 每 个 应 用 程序 需要 大 约 650MB 的 分 配 内 存 〈 而 上 面 的 示例 仅 分 配 了 
300MB) 。 我 们 可 以 通过 调用 cf set-env 命令 并 传递 JAVA _OPTS 参数 来 更 改 这 些 设置 ， 
如 以 下 代码 所 示 。 像 这 样 的 内 存 限 制 在 生产 模式 下 是 不 够 的 ， 但 可 以 用 于 测试 目的 。 要 
确保 这 些 更 改 和 生效， 可 以 使 用 cfrestage 命令 ， 如 下 所 示 。 

$ cf set-env account-service JAVA OPTS "-Xmx150M -Xss250K - 


XX:ReservedCodeCacheSize=70M -XX:MaxMetaspaceSize=90M" 
$ cf restage account-service 


分 配 的 内 存 很 重要 ， 特 别 是 如 果 只 有 2GB 内 存 可 用 于 免费 账户 。 应 用 默认 内 存 设 置 
后 ,我 们 就 只 能 在 Pivotal 平台 上 部 署 两 个 应 用 程序 , 因为 每 个 应 用 程序 占用 1GB 的 内 存 。 
虽然 已 经 解决 了 前 面 描述 的 问题 ， 但 我 们 的 应 用 仍然 无 法 正常 工作 。 

2. 绑 定 到 服务 

在 引导 期 间 ， 应 用 程序 无 法 连接 上 所 需 的 服务 。 出 现 此 问题 的 原因 是 服务 未 默认 绑 定 
到 应 用 程序 。 可 以 通过 运行 命令 cf services 来 显示 在 空间 中 创建 的 所 有 服务 , 并 通过 调用 
命令 cf bind- service 将 它们 中 的 每 一 个 绑 定 到 给 定 的 微服 务 。 在 以 下 示例 命令 的 执行 中 ， 
我 们 将 Eureka、 配 置 服务 器 和 MongoDB 都 绑 定 到 account-service 服务 。 最 后 ， 可 以 再 次 
运行 cf restage， 此 时 一 切 都 应 该 正常 工作 ， 如 下 所 示 。 

$ cf bind-service account-service discovery-service 


$ cf bind-service account-service config-service 
$ cf bind-service account-service sample-db 
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3. 使 用 Maven 插件 

如 前 文 所 述 , 命令 行 界 面 和 Web 控制 台 并 不 是 在 Pivotal 平台 上 管理 应 用 程序 的 唯一 
方法 。Cloud Foundry 团队 己 经 实现 了 Maven 插件 ， 以 促进 和 加 快 应 用 程序 部 署 。 有 趣 的 
是 ,同一 个 插件 可 用 于 管理 任何 Cloud Foundry 实例 的 推送 和 更 新 ， 而 不 仅 限 于 由 Pivotal 
提供 的 实例 。 

使 用 Cloud Foundry 的 Maven 插件 时 ， 开 发 人 员 可 以 轻松 地 将 云 部 署 集成 到 Maven 
项 目的 生命 周期 中 。 这 人 允许 开发 人 员 在 Cloud Foundry 中 推送 、 删 除 和 更 新 项 目 。 如 果 想 
要 将 项 目 与 Maven 一 起 推送 ， 只 需 运 行 以 下 命令 。 

$ mvn clean install cf:push 


一 般 来 说 ，Maven 插件 提供 的 命令 与 命令 行 界面 提供 的 命令 非常 相似 。 例 如 ， 开 发 
人 员 可 以 通过 执行 命令 mvn cfapps 来 显示 应 用 程序 的 列表 。 如 果 要 删除 某 个 应 用 程序 ， 
则 可 以 运行 以 下 命令 。 


$ mvn cf:delete -Dcf.appname = product-service 


如 果 要 将 茶 些 更 改 上 传 到 现 有 应 用 程序 ， 则 可 以 使 用 cfupdate， 其 命令 如 下 。 


$ mvn clean install cf:update 


在 运行 任何 命令 之 前 ， 都 必须 正确 配置 插件 。 首 先 ， 需 要 传递 Cloud Foundry 登录 凭 
据 。 建 议 将 它们 分 别 存储 在 Maven 的 settings.xml 文件 中 。 服 务 器 标记 内 的 典型 条 目 可 能 
如 下 所 示 。 


<Settjngs> 


<Servers> 
<Server> 
<id>cloud-foundry-credentials</id> 
<username>piotr.minkowskilplay.pl</username> 
<password>123456</password> 


</Server> 
</Servers> 
</settings> 
使 用 Maven 插件 而 不 是 命令 行 界面 的 命令 有 一 个 重要 的 优点 : 开发 人 员 可 以 在 一 个 


位 置 配置 所 有 必要 的 配置 设置 ， 并 可 以 在 应 用 程序 构建 期 间 使 用 单个 命令 应 用 它们 。 插 
件 的 完整 配置 显示 在 以 下 代码 段 中 。 除 了 一 些 基 本 设置 《包括 空间 、 内 存 和 大 量 实例 ) 
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之 外 ， 还 可 以 使 用 JAVA_OPTS 环境 变量 更 改 内 存 限 制 ， 并 将 所 再 服务 绑 定 到 应 用 程序 。 
运行 cfpush 命令 之 后 , 就 可 以 在 https://product-service-piomin.cfapps.io/ 地 址 使 用 product- 
service 服务 。 


<plugin> 
<qroupId>org.cloudfoundry</groupId> 
<artifactId>cf-maven-plugin</artifactId> 
<Version>l1.1.3</version> 
<Configuration> 
<target>http://api.run.pivotal.io</target> 
<Org>piotr.minkowski</org> 
<space>development</space> 
<appname>$ {project.artifactId}</appname> 
<memory>300</memory> 
<instances>l</instances> 
<server>cloud-foundry-credentials</server> 
<uUurl>https://product-service-piomin.cfapps.io/</url> 
<env> 
<JAVA OPTS>-Xmx150M -XSS2UK -XX:ReservedCodeCacheSize= /0M 一 
XX:MaxMetaspaceSize=90M</JAVA OPTS> 
</env> 
“SerVICeS> 
<SeErIVice> 
<name>sample-db</name> 
<label>mlab</label> 
<plan>sandbox</plan> 
</service> 
<SETVICe> 
<name>discovery-service</name> 
<label>p-service-registry</label> 
<plan>standard</plan> 
</sService> 
六 与 已 下 于 于 区 己 们 
<name>config-service</name> 
<label>p-config-server</label> 
<plan>standard</plan> 
</service> 
</sServices> 
</confiqguration> 
</plugin> 
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15.1.4 维护 


假设 开发 人 员 已 经 成 功 部 署 了 构建 基于 微服 务 的 示例 系统 的 所 有 应 用 程序 ， 那 么 现 
在 就 可 以 使 用 Pivotal Web Services 仪表 板 甚 至 命令 行 界面 的 命令 轻松 管理 和 监视 它们 。 
Pivotal 平台 提供 的 免费 试用 版 为 开发 人 员 提 供 了 许多 维护 应 用 程序 的 可 能 性 和 工具 ， 接 
下 来 我 们 将 介绍 一 些 有 趣 的 功能 。 

1. 访问 部 署 的 详细 信息 

开发 人 员 可 以 通过 运行 命令 cf apps 或 导航 到 Web 控制 台中 我 们 空间 的 主 站 点 来 列 出 
所 有 已 部 署 的 应 用 程序 。 在 如 图 15.2 所 示 的 屏幕 截图 中 即 可 看 到 该 列表 。 表 的 每 一 行 代 
表 一 个 应 用 程序 。 除 了 名 称 之 外 ， 还 有 关于 其 状态 、 实 例 数 、 分 配 的 内 存 、 部 署 时 间 以 
及 平台 外 可 用 服务 的 URL 信息 等 。 如 果 在 应 用 程序 部 署 期 间 未 指定 URL 地 址 ， 则 这 些 
URL 会 目 动 生 成 。 


区 多 Pivatal Web Services 


SPATFE RUNING Tt 
Wl development ® : 


Apps (4) Services (9 


Apps 


图 15.2 访问 部 车 的 详细 信息 


可 以 通过 单 击 每 一 行 来 了 解 有 关 该 应 用 程序 的 详细 信息 ， 也 可 以 在 命令 行 界 面 中 使 
用 命令 cf app <app-name> 或 cf app order-service 访问 类 似 信息 。 图 15.3 显示 了 应 用 程序 
详细 信息 视图 的 主 面板 ， 其 中 包含 每 个 实例 的 事件 历史 记录 、 摘 要 ， 以 及 内 存 、 人 磁盘 和 
CPU 使 用 情况 。 在 此 面板 中 ， 可 以 通过 单 击 Scale (扩展 ) 按钮 来 扩展 应 用 程序 。 还 有 其 
他 几 个 选项 卡 可 用 , 通过 切换 到 其 中 一 个 即 可 执行 相应 操作 。 例 如 ,， 单 击 Services (服务 ) 
可 以 检查 所 有 比 定 的 服务 ， 单 击 Route (路 由 ) 可 以 分 配 外 部 URL， 单 击 Logs (日 志 ) 
可 以 显示 日 志 ， 单 击 Trace (跟踪 ) 可 以 查看 传 入 请 求 的 历史 记录 。 

当然 ， 开 发 人 员 始 终 可 以 使 用 命令 行 界面 收集 与 上 一 示例 中 所 示 相 同 的 详细 信息 。 
如 果 执 行 cf logs <app-name> 命 令 ， 则 会 附加 到 由 应 用 程序 生成 的 stdout。 开 发 人 员 还 可 
以 使 用 绑 定 应 用 程序 列表 显示 已 激活 的 Pivotal 托管 服务 列表 ， 如 图 15.4 所 示 。 
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图 15.3 ”查看 有 关 应 用 程序 的 详细 信息 


CUsers minkoup>ef services 
Getting services in org Piotr ,minkonski / space develophent as piotr.minkonskiBplay.pl... 
Dk, 


be hh + he p-eonfig-3er er Standard account -service, Customer-seruice, oFder-seryice Pgate SC 
discouvery- Ser vlce PpP-Service-reglstry standard account-servlice, Customer -service, order-servlice, Product-service 尼 厂 克 司 七 电信 同性 仆 各 名 虽 虽 喇 
mney=-Felic newrelic standard account -service, customer -servyice, order-service, Product-service 眉 厂 必 可 十 色 ” 全 局 攻 改写 已 夺 必 对 
salmple=db mlab sandbox account -service, customer-service, order-service, Product-service 让 三 吧 吕 十 避 UGeded 


图 15.4 显示 已 激活 的 Pivotal 托管 服务 列表 


管理 应 用 程序 生命 周期 
Pivotal Web Services 提供 的 另 一 个 非 营 有 用 的 功能 是 管理 应 用 程序 生命 周期 的 能 
换 句 话说 ， 只 需 单 击 一 下 ， 我 们 就 可 以 轻松 地 停止 、 启 动 和 重新 启动 应 用 程序 。 在 执行 
请 求 命令 之 前 ， 系 统 将 出 现 提 示 要 求 确 认 ， 如 图 15.5 所 示 。 


Stop 


Are you sure you want to stop customer-service? 


图 15.5 系统 提示 要 求 确 认 操 作 
运行 以 下 命令 行 界 面 的 命令 之 一 可 以 实现 相同 的 结果 。 


$ cf stop <app-name> 
$ cf restart <app-name> 
$ cf start <app-name> 


3. 扩展 
使 用 云 解决 方案 的 最 重要 的 原因 之 一 是 能 够 轻松 扩展 应 用 程序 。Pivotal 平台 以 非常 
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直观 的 方式 处 理 这 些 问 题 。 痛 先 ， 开 发 人 员 可 以 决定 在 每 个 部 殴 阶 段 局 动 应 用 程序 的 实 
例 数 。 例 如 ， 如 果 决 定 使 用 manifest.yml 并 通过 cf push 命令 部 莹 它 ， 则 创建 的 实例 数 将 
由 字段 实例 确定 ， 如 以 下 代码 段 所 示 。 


applications: 
- name: account-service 
memory: 300M 
instances: 2 
host: account— service—plomin 
domain: cfapps.10 
path: target/account-service-l1.0-SNAPSHOT.Jjar 
可 以 在 局 动 的 应 用 程序 上 修改 止 在 运行 的 实例 数 以 及 内 存 和 CPU 限制 。 实 际 上 ， 有 
两 种 可 用 的 扩展 方法 。 开 发 人 员 既 可 以 手动 设置 应 启动 的 实例 数 ， 也 可 以 启用 自动 扩展 ， 
在 自动 扩展 中 ， 只 需 根 据 选 定 指标 的 浆 值 定义 一 个 条 件 即 可 。Pivotal 平台 上 的 上 自动 扩展 
功能 将 通过 一 个 名 为 PCF App Autoscaler 的 工具 实现 。 开 发 人 员 可 以 从 以 下 5 个 可 用 规则 
中 进行 选择 ， 具 体 如 下 。 
口 “CPU 利用 率 
内 存 利 用 率 
HTTP 延迟 
HTTP 吞吐 量 
RabbitMQ 深度 
开发 人 员 可 以 定义 多 个 活动 规则 。 对 于 回 下 扩展 (Scale Down) 来 说 ， 这 些 规则 中 
的 每 一 个 都 具有 单个 指标 的 最 小 值 ， 而 对 于 向 上 扩展 (Scale Up) 来 说 ， 上 自然 惑 是 最 大 值 
了 。 在 图 15.6 中 ， 显 示 了 customer-service 服务 的 目 动 扩展 设置 。 在 这 里 ， 我们 决定 应 用 
的 是 HITP Throughput (HTTP 吞吐 量 ) 和 HTTP Latency (HTTP 延迟 ) 规则 。 如 果 99% 
流量 的 延迟 低 于 20ms《〈 军 秒 ) ， 则 应 该 禁用 应 用 程序 的 一 个 实例 ， 因 为 连接 速度 足够 ， 
所 以 不 必 出 现 多 个 实例 ， 反 过 来 ， 如 果 延 过 大 于 200ms《〈 坚 秒 ) ， 则 平台 应 该 再 附加 一 
个 实例 ， 以 提高 处 理 能 
开发 人 员 还 可 以 手动 控制 运行 实例 的 数量 。 目 动 扩 展 具 有 许多 优点 ， 但 手动 方法 可 
以 让 开发 人 员 更 好 地 控制 该 过 程 。 由 于 每 个 应 用 程序 的 内 存 有 限 ， 因 而 仍 有 其 他 实例 的 
空间 。 在 我 们 的 示例 系统 中 ， 重 载 (Overload) 最 多 的 应 用 程序 是 account-service 服务 ， 
因为 它 在 订单 创建 期 间 需 要 调用 ， 在 订单 确认 时 叉 需 要 调用 。 所 以 ， 我 们 可 以 给 它 再 添 
加 一 个 实例 。 要 执行 此 操作 ， 可 以 转 到 account-service 服务 详细 信息 面板 ， 然 后 单 击 


DO LO 
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Processes and Instances (进程 和 实例 〉 下 的 Scale (扩展 ) 。 在 出 现 Scale app〔 扩 展 程序 ) 
设置 界面 时 ,在 Instances (实例 ) 框 中 输入 目标 实例 数 ， 然 后 单 击 APPLY CHANGES (应 
用 更 改 ) 按钮 ， 如 图 15.7 所 示 。 经 过 这 样 的 修改 之 后 ， 开 发 人 员 应 该 看 到 两 个 可 用 的 
account-service 服务 实例 。 


customer-service 


ENABLED | 国 | 


Edit Scaling Rules 
Apps scaole py 1 instonce Per event. Apps will scole up 
When any metric moximum iis met and scale down only 
When all metric mnums are met. 

HTTP Throughput | 外 delete 


scale down if less than: 


scale up if more than: 


x Scaleapp 


HTTP Latency | © delete a 


Scale down if less than: 20 ms Instances Memory Limit Disk Limit 


Scale up if more than: 200 ms 2 350 MB 1 GB 


Percent of traffic to apply: 95% 时 999% 


Usage Total 
Instances -Memory Limit Disk Limit 


2 0.68 GB 2.00 GB 


图 15.6 ”上 自动 扩展 规则 设置 图 15.7 手动 控制 运行 实例 的 数量 
4. 提供 代理 服务 


我 们 已 经 了 解 了 如 何 使 用 cf bind-service 命令 和 Maven 插件 将 应 用 程序 绑 定 到 服务 。 
但 是 ， 我 们 现在 应 该 看 看 如 何 启 用 和 配置 服务 。 开 发 人 员 可 以 轻松 显示 所 有 可 用 服务 的 
列表 ， 然 后 使 用 Pivotal 的 仪表 板 启 用 它们 ， 这 可 以 在 Marketplace 市场) 下 找到 。 

使 用 Pivotal Web Services 提供 代理 服务 非 间 容易。 在 安装 之 后 ， 某 些 服务 已 可 供 使 
用 ， 而 无 须 任何 其 他 配置 。 我 们 所 要 做 的 就 是 将 它们 绑 定 到 选 定 的 应 用 程序 ， 并 在 应 用 
程序 的 设置 中 正确 传递 其 网 络 地 址 。 通 过 用 户 界 面 仪表 板 可 以 轻松 地 将 每 个 应 用 程序 绑 


"EE 
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定 到 服务 。 首先， 导航 到 服务 的 主页 面 。 在 那里 ， 开 发 人 员 将 看 到 当前 绑 定 的 应 用 程序 
列表 。 可 以 先 单 击 BIND APP《〈 绑 定 应 用 程序 ) 按钮 ， 然 后 从 显示 的 列表 中 选择 一 个 程序 
来 将 新 应 用 程序 绑 定 到 服务 ， 如 图 15.8 所 示 。 


discovery-service 
SE ERVICE: Senice Repelsry PLAN stanadard 


ET Ran 大 ES 


BiND APP 


图 15.8 ” 绑 定 应 用 程序 


除了 在 Marketplace《〈 市 场 ) 中 局 用 注册 表 服 务 并 将 其 绑 定 到 应 用 程序 以 便 在 Pivotal 
Web 服务 上 局 用 发 现 功能 之 外 ， 开 有 人 员 不 必 执 行 任何 其 他 操作 。 当 然 ， 如 果 需 要 ， 也 
可 以 在 客户 端 履 兰 某 些 配置 设置 。 已 注册 的 应 用 程序 的 完整 列表 可 以 显示 在 服务 主 配置 
面板 中 Manage 〈 管 理 ) 下 的 Eureka 仪表 板 中 。 在 图 15.9 中 可 以 看 到 ， 有 两 个 正在 运行 
的 account-service 服务 实例 , 这 是 因为 之 前 已 对 其 进行 了 扩展 , 但 是 其 他 微服 务 仍然 只 有 
一 个 运行 实例 。 


俐 Home 四 History 
Service Keglstry Status 
Reglstered Apps 


Application Availability Zones 铀 二 坷 起 则 后 


ACCOUNT-SERVICE default [2 SY UP (2) 


里 吾 CCOUNTE-Se 


CUSTOMER-SERVICE dafault [1 


a Customer-service-restless-chimpanzee.ctapps.io:ds1f7bd0-a65a7-4b23-6879-854b 


ORDER-SERVICE defautt [1 


a order-service-piomin.cfapps.io:b9e5995a-a3b9-439b-58ac2-7996 


PRODUCT-SERYVICE default [] 合 UP (1) 


* product-service-quick-baboon.cfapps.io.2ef5220c-89cd-42 


图 15.9 查看 已 注册 的 应 用 程序 的 完整 列表 
与 发 现 服务 相 比 ， 配 置 服务 器 需要 包含 其 他 设置 。 和 以 前 一 样 ， 开 发 人 员 应 该 导航 
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到 其 主 面板 ， 然 后 选择 Manage( 管 理 ) 。 在 这 里 ， 开 发 人 员 将 被 重 定 同 到 配置 表单 ， 并 
且 在 那里 必须 提供 配置 参数 作为 JSON 对 象 。count 参数 指定 供应 所 需 的 节点 数 ， 如 果实 
例 可 以 升级 则 选中 Upgrade( 升 级) 选项， 而 force 参数 则 会 强制 升级 ， 即 使 当前 实例 已 
经 是 最 新 可 用 的 版 本 。 其 他 配置 参数 取决 于 用 于 存储 属性 源 的 后 端 类 型 。 关 于 存储 属性 
源 的 后 端 类 型 ， 在 本 书 第 5 章 “ 使 用 Spring Cloud Config 进行 分 布 式 配 置 ” 中 已 经 详细 
介绍 过 , 最 流行 的 Spring Cloud Config Server 解决 方案 是 基于 Git 存储 库 的 。 我 们 在 GitHub 
上 创建 了 一 个 示例 存储 库 ， 其 中 提交 了 所 有 必需 的 源 。 以 下 是 应 在 Pivotal Web Services 
上 为 Config Server 提供 的 JSON 格式 的 参数 。 
{ 


“Count -| 

ye DD ele 
人 
et Fk ws Ole 
"https://github.com/piomin/sample—spring—-cloud-pcf-config.git™, 
"username"”: "piomin™ 


) 

我 们 提供 的 示例 应 用 程序 使 用 的 最 后 一 个 代理 服务 托管 了 一 个 MongoDB 实例 ,在 该 
服务 的 主 面板 上 导航 到 Manage( 管 理 ) 之 后 ,开发 人 员 应 该 被 重 定 同 到 https://mlab.com/ 
home， 在 那里 将 能 够 使 用 数据 库 的 节点 。 


15.2 Heroku 平台 


Heroku 是 使 用 平台 即 服务 (PaaSs) 模型 创建 的 最 古老 的 云 平台 之 一 。 与 Pivotal Cloud 
Foundry 相 比 ，Heroku 没有 内 置 的 Spring Cloud 应 用 程序 支持 ， 这 会 使 开发 人 员 的 模型 稍 
微 复杂 化 ， 因 为 这 意味 着 无 法 使 用 平台 的 服务 来 启用 典型 的 微服 务 组 件 ， 包 括 服务 发 现 、 
配置 服务 堪 或 断路 嚣 。 尽 管 如 此 ，Herolkm 仍 包 含 了 一 些 Pivotal Web Services 无 法 提供 的 
非常 有 趣 的 功能 。 


15.2.1 部 署 方法 
开发 人 员 可 以 使 用 命令 行 界面 、Web 控制 台 或 专用 的 Maven 插件 管理 自己 的 应 用 程 


序 。 部 署 Heroku 与 部 署 Pivotal 平台 非常 相似 ， 但 方法 略 有 不 同 。 主 要 方法 假定 开发 人 员 
通过 从 存储 在 本 地 Git 存储 库 或 GitHub 上 的 源 代 码 构 建 应 用 程序 来 部 署 应 用 程序 。 在 将 
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分 文中 的 革 些 更 改 推送 到 存储 库 之 后 ， 构 建 将 由 Heroku 平台 目 动 执行 。 或 者 ， 也 可 以 根 
据 所 选 分 文中 的 最 新 版 本 代码 的 要 求 执行 构建 。 部 署 应 用 程序 的 另 一 个 有 趣 方 法 是 将 
Docker 镜像 推送 到 Heroku 的 容 占 注册 表 。 
使 用 命令 行 表面 

要 使 用 命令 行 界面 ， 首 先 需要 下 载 https:/Wcli-assets. We conyheroku-clychannels/ 
stable/heroku-cli-x64.exe (适用 于 Windows) 并 安装 Heroku 命令 行 界 面 CCLI) 。 要 使 用 
命令 行 界面 在 Heroku 上 部 署 和 运行 应 用 程序 ， 必 须 执行 以 下 步 又。 

(1) 安装 之 后 ， 可 以 使 用 shell 中 的 命令 Heroku。 首 先 ， 开 发 人 员 需 要 使 用 凭据 登 

杂 Heroku， 如 下 所 示 。 

$ heroku login 

Enter your Heroku credentials: 

Email: piotr.minkowskil@play .pl 


PassWwWord: 太太 炎炎 炎炎 火 太 


Logged in as piotr.minkowskilplay .pl 


(2) 现在 导航 到 应 用 程序 的 root 目录 并 在 Heroku 上 创建 一 个 应 用 程序 。 运 行 以 下 
命令 后 ， 不 仅 会 创建 应 用 程序 ， 还 会 创建 一 个 名 为 heroku 的 Git 远程 主机 ， yh 
Git 存储 库 相 关联 的 ， 如 下 上 所 示 。 

$ heroku Create 
Creating app... done, aqueous-retreat-66586 
https://aqueous-retreat-66586.herokuapp.com/ | 


https://git.heroku.com/aqueous-retreat-66586.git 
Git remote heroku added 


(3) 此 时 可 以 通过 将 代码 推送 到 Heroku 的 Git 远程 主机 来 部 署 应 用 程序 。Heroku 
将 目 动 完成 所 有 工作 ， 如 下 所 示 。 
$ git Push heroku master 


(4) 如 果 应 用 程序 成 功 局 动 ， 则 开发 人 员 将 能 够 使 用 一 些 基本 命令 进行 管理 。 按 照 
如 下 所 示 的 顺序 ， 可 以 显示 日 志 、 更 改正 在 运行 的 Dynos 的 数量 ( 换 句 话说 ， 其 实 就 是 
扩展 应 用 程序 ) 、 分 配 新 的 加 载 项 (Addons) ， 并 列 出 所 有 已 启用 的 加 载 项 。 
$ heroku logs --tail 
$ heroku Ps: scale web = 2 
$ heroku addons: create mongolab 
$ heroku addons 
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2. 连接 到 GitHub 存储 库 

束 个 人 而 言 ， 笔 者 更 喜欢 通过 使 用 GitHub 存储 库 连 接 到 项 目 来 将 应 用 程序 部 署 到 
Heroku。 这 种 部 荀 方法 同样 有 两 种 可 能 的 方式 : 手动 和 自动 。 开 发 人 员 可 以 选择 导航 到 
应 用 程序 详细 信息 面板 上 的 Deploy 部署) 选项 卡 ， 然 后 将 其 连接 到 指定 的 GitHub 存储 
库 ， 如 图 15.10 所 示 。 如 果 单 击 Deploy Branch (部 署 分 支 ) 按钮 ， 则 会 立即 从 给 定 的 Git 
开始 构建 并 部 署 到 Heroku。 或 者 , 开发 人 员 也 可 以 通过 单 击 Enable Automatic Deploys (局 
用 自动 部 署 ) 按钮 在 所 选 分 文 上 局 用 目 动 部 署 。 此 外 ， 如 果 为 GitHub 存储 库 启 用 了 
Heroku， 则 可 以 将 Heroku 配置 为 等 竺 持续 集成 构建 结果 。 这 是 一 个 非常 有 用 的 功能 ， 因 
为 它 允 许 开 发 人 员 对 项 目 运 行 日 动 化 测试 并 确保 它们 在 推送 之 前 就 已 经 通过 。 


App connected to GitHub 2 
Connected to OY piomin/sample-heroky-accownt-seryice by 才 Plomin 
Code difis, manual and auto deploys are 
avallable for this app, : 4 有 a SR 
Releases in the activity feed link to GitHub to view commit dits 


Fnable automatic deploys from GitHub 


Ewery push to the branch you specify here will deploy a new version of this app. Deploys happen automatically: be sure that this 


branch Is alvays in a deployable state ard any tests have passed betore you push. Learn nn 


Mraster 


Wait for CL to pass bafore daploy 


Enable Automatic Deploys 


15.10 ”连接 到 GitHub 存储 库 
3. Docker 容器 注册 表 
Heroku 遵循 了 最 新 趋势 ， 人 允许 开发 人 员 使 用 Docker 部 署 容 堪 化 应 用 程序 。 为 了 能 够 
做 到 这 一 点 ， 开 发 人 员 应 该 在 本 地 计算 机 上 安装 Docker 和 Heroku 命令 行 界面 。 
(1) 首先 ， 需 要 通过 运行 heroku login 命令 登录 Heroku Cloud。 下 一 步 则 是 登录 到 
Container Registry( 容 右 注 册 表 ) 。 
$ heroku container: login 
(2) 接 下 来 ， 需 要 确保 当前 目录 包含 Dockerfile。 如 果 存 在 ， 则 可 以 继续 构建 并 通 
过 执行 以 下 命令 将 镜像 推送 到 Heroku 的 Container Registry。 


$ heroku container:push web 
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(3) 如 果 有 现成 的 构建 镜像 ， 则 可 以 标记 它 并 将 其 推送 到 Heroku。 要 完成 此 任务 ， 
需要 通过 执行 以 下 命令 来 使 用 Docker 的 命令 行 〈 假 设 当前 应 用 程序 的 名 称 是 piomin- 
order-service) 。 

$ docker tag piomin/order-service registry.heroku.app/piomin-order- 


service/web 
$ docker push registry.heroku.app/piomin-order-service/web 


在 成 功 推送 镜像 之 后 ， 新 应 用 程序 应 在 Heroku 仪表 板 中 可 见 。 
15.2.2 ”准备 应 用 程序 


在 将 基于 Spring Cloud 组 件 的 应 用 程序 部 署 到 Heroku 时 ， 开 发 人 员 不 再 需要 对 其 源 
代码 执行 任何 额外 更 改 或 添加 任何 其 他 库 ， 因 为 这 在 按 本 地 方式 运行 时 就 已 经 做 了 。 这 
里 唯一 的 区 别 在 于 配置 设置 开发 人 员 应 该 设置 一 个 地 址 ， 以 便 将 应 用 程序 与 服务 发 现 、 
数据 库 或 任何 其 他 可 以 为 微服 务 启用 的 加 载 项 集成 。 当 前 示例 与 为 Pivotal 部 署 提供 的 示 
例 相 同 ， 将 数据 存储 在 MongoDB 中 ， 访 数据 将 作为 mLab 服务 分 配给 应 用 程序 。 此 外 ， 
在 本 示例 中 ,每 个 客户 端 都 会 在 Eureka 服务 器 上 注册 它们 目 己 ， 该 Eureka 服务 器 被 部 熙 
为 piomin-discovery-service。 我 们 的 示例 在 Heroku 上 部 署 的 应 用 程序 列表 如 图 15.11 所 示 。 


OO Personal 


piomin-account-service 


15.11 在 Heroku 上 部 署 的 应 用 程序 列表 


我 们 通过 将 应 用 程序 与 GitHub 存储 库 连 接 的 方式 在 Heroku 上 部 普 了 这 些 应 用 程序 。 
有 反 过 来 ， 这 需要 为 每 个 微服 务 创 建 一 个 单独 的 存储 库 。 例 如 ，order-service 服务 的 存储 库 
可 以 在 https://github.com/piomin/sample-heroku-order-service.git 获得 ， 其 他 微服 务 可 能 处 
于 类 似 的 地 址 下 。 开 发 人 员 可 以 轻松 地 分 开 这 些微 服务 并 将 其 部 署 在 上 自己 的 Heroku 账户 
上 以 执行 测试 。 

现在 以 account-service 应 用 程序 为 例 ， 来 仔细 看 一 看 如 何 提供 配置 设置 。 首 先 ， 我 们 
必须 使 用 Heroku 平 台 提供 的 MONGODB URI 环 境 变量 覆盖 MongoDB 的 自动 配置 地 址 。 
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此 外 ， 还 必须 提供 Eureka 服务 器 的 正确 地 址 ， 以 及 在 注册 期 间 才 盖 由 发 现 客户 端 发 送 的 
主机 名 和 端口 。 这 是 必需 的 操作 ， 因 为 在 默认 情况 下 ， 每 个 应 用 程序 都 会 尝试 使 用 其 他 
应 用 程序 无 法 使 用 的 内 部 地 址 进行 注册 。 如 果 开 发 人 员 不 者 盖 这 些 值 ， 则 与 Feign 客户 病 
的 服务 则 通信 将 失败 。 
Spring: 
application: 
name: account—service 
data: 
mongodb: 
uri: S${MONGODB URI} 
eureka: 
instance: 
hostname: S${HEROKU APP NAME}.herokuapp.com 
nonSecurePort: 80 
cliient.: 
ServiceUrl: 
defaultzone: http://piomin-discovery-service.herokuapp.com/eureka 


请 注意 ， 环 境 变量 HEROKU APP NAME 是 部 署 在 Heroku 上 的 当前 应 用 程序 的 名 
称 ， 如 前 面 的 代码 段 所 示 ， 且 默认 情况 下 不 可 用 。 要 为 应 用 程序 启用 变量 (如 customer- 
service) ， 可 以 使 用 实验 性 的 加 载 项 runtime-dyno-metadata 运行 以 下 命令 。 


$ heroku labs: enable runtime-dyno-metadata -a piomin-customer-service 


15.2.3 测试 部 署 


在 部 署 完成 之 后 ， 每 个 应 用 程序 都 可 以 在 由 其 名 称 和 平台 域名 组 成 的 地 址 上 使 

用 ， 如 http://piomin-order-service.herokuapp.com。 开 发 人 员 可 以 使 用 公开 的 URL 地 址 
(http://piomin-discovery-service.herokuapp.conmy ) 调用 Eureka 仪表 板 ， 这 将 允许 开发 人 员 
检查 示例 微服 务 是 否 已 经 注册 。 如 果 一 切 正 常 ， 则 应 该 看 到 类 似 于 图 15.12 所 示 的 内 容 。 


Instances currently registered with Eureka 


] Application Mls hvailability Zones Status 


ACCOUNT-SERWICE nia ll) I UPI1)- 4788503e-2d95-43d3-a7f0-111186aa0692 prve.dy 
CUSTOMER-SERYVICE nia (i) | UP11) - bb2dbda3 


DRDER-SERWICE Miall) | UPIl1)- 77O0d1S584-9fed-4536-8835-5d376f365a28,prvt,.dyno.rt heroku.cormorder-servlice:d43145 


PRODUCT-SERYVICE nfa tll) 


15.12 ”已 经 注册 的 Eureka 服务 实例 
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由 于 每 个 微服 务 都 已 经 公开 了 由 Swagger2 目 动 生成 的 API 文档 , 因而 可 以 访问 /swagger- 
ui.html。 打 开 Swagger 用 户 界 面 仪表 板 (如 http://piomin-customer-service.herokuapp.conmy 


swagger-ui.html), 然后 通过 调用 每 个 端点 来 轻松 测试 它们 。customer-service 服务 的 HTTP 
API 的 可 视 化 结果 如 图 15.13 所 示 。 


JET Fi i 和 
| DELETE | rcustomer/ {Lid} delete 


reustomer, ids find 


/customer /withAccounts/{id} hmrdByidiWithaccounts 


图 15.13 在 Swagger 用 户 界面 仪表 板 查 看 服务 的 API 


每 个 微服 务 都 会 将 数据 存储 在 MongoDB 中 ,可 以 通过 添加 Heroku 提供 的 加 载 项 (如 
mLab ) 为 项 目 启 用 此 数据 库 。 如 前 文 所 述 ， 我 们 已 经 使 用 了 相同 服务 的 示例 来 在 Pivotal 
平台 上 部 署 的 应 用 程序 中 存储 数据 。 要 为 应 用 程序 局 用 加 载 项 ， 可 以 找到 每 个 应 用 程序 
的 详细 信息 面板 的 Resources (资源 ) 选项 卡 ， 然 后 为 选 定 的 计划 配置 加 载 项 。 完 成 后 ， 开 
发 人 员 只 需 单 击 即 可 管理 每 个 插件 。 对 于 mLab 来 说 , 将 重 定 向 到 mLab 站 点 (mlab.com)， 
在 该 站 点 中 可 以 看 到 所 有 和 集合、 用 户 和 生成 的 统计 信息 的 列表 。 本 示例 的 mLab 仪表 板 如 
图 15.14 所 示 。 


Collections Backups Teols 


Collections Delete all colections 上 Add collection 


15.14 查看 mLab 仪表 板 
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I53 a 结 


我 们 已 经 到 达 Spring Cloud 微服 务 之 旅 的 终点 ! 我 们 的 练习 始 于 本 地 计算 机 上 的 简 
单 部 普 ， 但 在 第 14 章 中 ， 我 们 已 经 将 微服 务 部 署 在 由 云 供应 商 完 全 管理 的 环境 中 ， 它 将 
自动 构建 、 启 动 和 公开 指定 域 上 的 HTTP API。 笔 者 个 人 认为 ， 使 用 任何 最 流行 的 编程 语 
言 或 第 三 方 工具 《如 数据 库 或 消 奶 代理 ) ， 开 发 人 员 可 以 轻松 地 运行 和 扩展 应 用 程序 ， 
以 及 公开 应 用 程序 之 外 的 数据 。 事 实 上 ， 我 们 每 个 人 现在 都 可 以 在 几 个 小 时 内 实现 并 局 
动 可 用 于 生产 模式 的 应 用 程序 ， 而 无 须 担心 必须 安装 的 软件 。 

本 章 展示 了 如 何 轻松 地 在 不 同 平 台 上 运行 Spring Cloud 微服 务 。 通 过 示例 演示 了 云 
原生 应 用 程序 的 真正 威力 。 无 论 是 在 笔记 本 电脑 上 以 本 地 方式 启动 应 用 程序 ， 还 是 在 
Docker 容器 内 部 或 使 用 Kubernetes, 甚至 是 在 Heroku 或 Pivotal Web Services 等 在 线 云 平 
台 上 启动 应 用 程序 ， 开 发 人 员 都 不 必 更 改 应 用 程序 源 代码 中 的 任何 内 容 ， 而 仅 需 要 在 
其 属性 中 执行 一 些 修改 (假设 在 架构 中 使 用 了 Config Server， 那 么 这 些 更 改 都 不 是 侵入 
性 的 ) 。 

在 本 书 的 最 后 两 章 中 ， 我 们 研究 了 IT 世界 中 的 一 些 最 新 趋势 。 现 在 已 经 有 越 来 越 多 
的 企业 或 组 织 开始 讨论 和 使 用 诸如 持续 集成 和 持续 区 付 (CLCD) 、 使 用 Docker 的 容 右 
化 、 使 用 Kubernetes 的 编排 以 及 云 平台 之 类 的 技术 。 实 际 上 ， 这 些 解 决 方案 也 是 微服 务 
日 益 普 及 的 部 分 原因 。 目 前 ， 该 编程 领域 有 一 个 领导 者 一 一 Spring Cloud。Spring Cloud 
所 具有 的 功能 之 丰 定 ， 可 以 实现 的 与 微服 务 相 关 的 模式 之 多 ， 目 前 尚 无 其 他 Java 框架 可 
以 与 之 媲美 。 囊 心 硕 望 本 书 能 够 帮助 开发 人 员 有 效 使 用 此 框 桨 ， 从 而 更 好 地 构建 和 磨 全 
自己 的 基于 微服 务 的 企业 系统 。 


